Actual Budget: seu próprio gerenciador de orçamento pessoal em um VPS

Um aplicativo bancário mostra para onde o dinheiro já foi. O Actual Budget responde a outra pergunta: quanto do valor disponível pode realmente ser gasto quando uma parte já está reservada para aluguel, alimentação, férias e despesas imprevistas?

O Actual Budget é um gerenciador de finanças pessoais gratuito e de código aberto. Ele funciona localmente, sincroniza por meio do seu próprio servidor e oferece criptografia de ponta a ponta. A seguir, veremos seus recursos, limitações e a instalação em um VPS.

Actual Budget em sete etapas

1. Criar um VPS Linux e apontar um subdomínio para ele, por exemplo, budget.example.com.
2. Instalar o Docker e o Docker Compose.
3. Iniciar o contêiner oficial com um diretório de dados persistente.
4. Configurar HTTPS com o Caddy.
5. Definir uma senha do servidor e criar um orçamento.
6. Adicionar contas, categorias, regras e pagamentos recorrentes.
7. Ativar a criptografia e configurar um backup externo.

O que é o Actual Budget

O Actual Budget é um aplicativo auto-hospedado para gerenciar o orçamento pessoal ou familiar. Ele é frequentemente considerado uma alternativa aberta ao YNAB, mas também é possível começar com um orçamento totalmente novo.

O serviço utiliza o método dos envelopes virtuais. Suponha que haja 100.000 rublos nas contas. Desse valor, 40.000 são necessários para moradia, 20.000 para alimentação, 10.000 para serviços públicos e 15.000 para uma reserva. Depois da distribuição, restam apenas 15.000 rublos para compras não essenciais, e não os 100.000 completos.

Essa abordagem muda a função do aplicativo. Um rastreador de despesas comum explica os gastos passados, enquanto o Actual Budget ajuda a tomar uma decisão antes da compra. O saldo não utilizado de uma categoria é transferido para o período seguinte e, em caso de excesso de gastos, é possível mover dinheiro de outro envelope.

Outra diferença é a arquitetura local-first. O orçamento fica armazenado nos dispositivos conectados e continua disponível sem Internet. Quando a conexão retorna, as alterações são sincronizadas pelo servidor. O VPS é usado principalmente para trocar dados entre computador, telefone e navegadores, e não para processar cada operação.

Principais recursos do Actual Budget

• Orçamento por envelopes. Apenas o dinheiro já recebido é distribuído.
• Contas e transações. Há suporte a transferências, divisão de uma compra entre várias categorias, observações e conciliação de saldo.
• Regras e agendas. É possível limpar descrições bancárias, atribuir categorias e considerar antecipadamente salário, aluguel ou assinaturas.
• Importação. São compatíveis os formatos CSV, QIF, OFX, QFX e CAMT. Formatos com identificadores de transação protegem melhor contra duplicatas.
• Relatórios. Estão disponíveis fluxo de caixa, patrimônio líquido, despesas e gráficos personalizáveis.
• Migração e API. Há importação do YNAB4 e da versão atual do YNAB, além de uma API para integrações próprias.

No telefone, o Actual Budget é instalado como PWA, ou seja, um aplicativo web adicionado à tela inicial. Vale a pena testar antes se a interface móvel é adequada para você.

Parâmetro	Serviço em nuvem	Actual Budget
Armazenamento	No provedor	No dispositivo e no seu próprio servidor
Uso sem Internet	Depende do serviço	As funções principais ficam disponíveis localmente
Manutenção	Feita pelo provedor	Feita pelo proprietário
Custo do programa	Assinatura ou plano gratuito	Não há assinatura obrigatória
Controle dos dados	Conforme as regras do provedor	Nas mãos do proprietário do servidor

O Actual Budget é indicado para quem valoriza privacidade e controle. Um serviço em nuvem é mais conveniente para quem não quer administrar um servidor.

Requisitos de servidor do Actual Budget

O projeto não publica um mínimo rígido de CPU e RAM. O servidor sincroniza principalmente pequenos volumes de dados financeiros, portanto uma configuração inicial razoável para uma pessoa ou família é:

• 1 vCPU;
• 1 GB de RAM;
• SSD de 10 GB;
• Ubuntu 24.04 LTS;
• um domínio ou subdomínio;
• espaço externo para o backup.

Esta é uma recomendação prática, e não um mínimo oficial. Para executar outros contêineres, é melhor reservar 2 GB de RAM.

Como instalar o Actual Budget em um VPS

O exemplo utiliza Ubuntu 24.04 e o subdomínio budget.example.com.

1. Prepare o servidor

Crie um registro DNS A apontando para o endereço IP do VPS, conecte-se por SSH e abra somente as portas necessárias:

ssh root@SERVER_IP

apt update && apt upgrade -y
apt install -y ca-certificates curl ufw

ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable

2. Instale o Docker

Adicione o repositório oficial do Docker:

install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg \
  -o /etc/apt/keyrings/docker.asc
chmod a+r /etc/apt/keyrings/docker.asc

cat > /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Architectures: $(dpkg --print-architecture)
Signed-By: /etc/apt/keyrings/docker.asc
EOF

apt update
apt install -y docker-ce docker-ce-cli containerd.io \
  docker-buildx-plugin docker-compose-plugin

3. Inicie o Actual Budget

mkdir -p /opt/actual-budget/data
cd /opt/actual-budget

cat > compose.yml <<'EOF'
services:
  actual:
    image: actualbudget/actual-server:latest
    restart: unless-stopped
    ports:
      - "127.0.0.1:5006:5006"
    volumes:
      - ./data:/data
EOF

docker compose up -d
docker compose ps

A vinculação a 127.0.0.1 impede que a porta 5006 seja exposta diretamente à Internet. Os orçamentos são salvos em /opt/actual-budget/data e não desaparecem quando o contêiner é atualizado.

4. Configure o HTTPS

apt install -y caddy

cat > /etc/caddy/Caddyfile <<'EOF'
budget.example.com {
    reverse_proxy 127.0.0.1:5006
}
EOF

caddy validate --config /etc/caddy/Caddyfile
systemctl reload caddy

Quando o DNS aponta para o VPS e as portas 80 e 443 estão acessíveis, o Caddy obtém automaticamente um certificado TLS. Abra https://budget.example.com e defina uma senha longa para o servidor.

Como configurar o primeiro orçamento

Não é obrigatório começar importando vários anos de histórico. É mais rápido adicionar as contas em uso, informar os saldos atuais e criar categorias para pagamentos obrigatórios, despesas diárias, economias e gastos irregulares.

Distribua apenas o dinheiro já disponível até que o valor “a distribuir” chegue a zero. Em seguida, importe as transações recentes, confira os saldos e crie regras para lojas, assinaturas e transferências frequentes.

As categorias devem ajudar na tomada de decisões. Envelopes separados para “saúde”, “conserto de equipamentos” e “assinaturas anuais” são mais úteis do que uma categoria geral “outros”.

O que é preciso saber sobre a sincronização bancária

A conexão bancária não está disponível em todos os países e depende do provedor de API compatível. Ela exige um servidor próprio e credenciais adicionais. O Actual Budget não executa a sincronização de forma totalmente automática: o usuário precisa iniciá-la na interface.

Os tokens das conexões bancárias são armazenados separadamente no servidor e não fazem parte da criptografia de ponta a ponta do orçamento. Se um banco específico não for compatível, as transações podem ser importadas de um extrato. OFX e QFX costumam ser mais convenientes que CSV porque contêm identificadores de transação.

Criptografia, backups e atualizações

A criptografia de ponta a ponta é ativada separadamente para cada orçamento. A senha deve ser guardada em um gerenciador de senhas, pois o servidor não poderá recuperá-la. O próprio Actual Budget não criptografa a cópia local, portanto o telefone e o computador devem ser protegidos com código de bloqueio e criptografia de disco.

Sincronização não substitui backup. Exporte regularmente o orçamento pelas configurações e copie o diretório de dados para outro local:

cd /opt/actual-budget
docker compose stop
tar -czf /root/actual-budget-$(date +%F).tar.gz data
docker compose start

O arquivo deve ser transferido para fora do VPS. Antes de uma atualização, também crie uma cópia e depois execute:

cd /opt/actual-budget
docker compose pull
docker compose up -d

Para uso contínuo, escolha a tag estável latest, e não a tag experimental nightly.

Qual VPS escolher para o Actual Budget

Uma instância pessoal não precisa de um servidor potente. Um VPS Linux básico da tropic.host é suficiente para hospedar o Actual Budget, o Caddy e um subdomínio com HTTPS. É razoável começar com 1 GB de RAM e aumentar os recursos somente ao adicionar outros serviços auto-hospedados.

Não exponha diretamente a porta 5006, instale as atualizações e mantenha pelo menos um backup fora do VPS principal. A segurança de um serviço auto-hospedado depende da configuração feita pelo proprietário.

Limitações do Actual Budget

O Actual Budget exige manutenção por conta própria. A sincronização bancária é limitada por país e provedor, a versão móvel funciona como PWA e a perda da senha de criptografia pode impedir o acesso ao orçamento.

O serviço não é adequado para todos, mas resolve bem uma tarefa específica: reúne o método dos envelopes, automação e controle dos dados sem exigir uma assinatura.

Resumo

O Actual Budget transforma o registro de despesas em um plano: cada valor recebido ganha uma finalidade antecipadamente. O aplicativo funciona localmente, sincroniza por meio do seu próprio servidor e oferece importação, regras, relatórios e criptografia.

Um VPS pequeno é suficiente para executá-lo. Depois da instalação, o mais importante é configurar HTTPS, guardar a senha de criptografia e preparar um backup externo.

FAQ

O Actual Budget é gratuito?

Sim. O aplicativo é distribuído como código aberto e não exige assinatura obrigatória. O VPS, o domínio e o armazenamento de backup são pagos separadamente.

É obrigatório instalar o Actual Budget em um VPS?

Não. Ele pode ser usado localmente em um único computador. O servidor é necessário para sincronizar dispositivos, conectar bancos, usar a API e manter acesso web permanente.

É possível conectar o Actual Budget ao banco?

Sim, desde que o banco e a região sejam compatíveis com um dos provedores disponíveis. Caso contrário, as transações podem ser importadas de arquivos CSV, QIF, OFX, QFX ou CAMT.

É seguro armazenar o orçamento no próprio servidor?

Sim, quando configurado corretamente, mas a responsabilidade é do proprietário. São necessários HTTPS, uma senha longa, criptografia, atualizações e backups externos.

De quanta memória RAM o Actual Budget precisa?

Não existe um mínimo oficial. Para uma instância pessoal, 1 GB de RAM é um ponto de partida prático; se outros serviços forem hospedados, é melhor reservar 2 GB.