Hospedar Actual Budget em um VPS gerenciado: seus orçamentos em seu servidor

Hospedar o Actual Budget em um VPS gerenciado é guardar seus orçamentos e a sincronização deles em uma máquina própria, que nossas equipes mantêm atualizada e supervisionam dia e noite. O Actual Budget é uma ferramenta de finanças pessoais local-first, publicada sob a licença MIT. Este guia segue a documentação oficial dele: o papel do servidor, a instalação com Docker Compose, o HTTPS, a senha do servidor, o OpenID, a criptografia de ponta a ponta, a sincronização bancária, os backups e as atualizações.

Simon Vasconcelos Lee Por Publicado em 17 de novembro de 2026Leitura: 14 minutos

Todos os guias

O essencial

  1. A licença MIT permite usar, modificar e redistribuir o Actual Budget livremente, desde que o aviso de copyright e de licença dele permaneça nas cópias.
  2. O servidor sincroniza seus orçamentos entre seus dispositivos e serve o aplicativo web: instale-o com Docker Compose, uma imagem e uma pasta de dados.
  3. O HTTPS é indispensável: o aplicativo precisa de SharedArrayBuffer, que os navegadores só ativam em uma página servida em HTTPS. Um proxy reverso cuida disso.
  4. Abra seu endereço logo na primeira inicialização do servidor para escolher a senha do servidor. O OpenID acrescenta a autenticação em duas etapas de seu provedor e vários usuários.
  5. A criptografia de ponta a ponta, opcional, torna seus orçamentos ilegíveis para o servidor. Faça backup da pasta de dados e exporte seus orçamentos, e atualize com docker compose pull.

O que o Actual Budget faz, e o papel do servidor dele

O Actual Budget é uma ferramenta de finanças pessoais local-first escrita em Node.js, que o README dele descreve como totalmente gratuita e de código aberto. Ele guarda todos os seus dados em cada um de seus dispositivos e os sincroniza em segundo plano com o servidor que você escolheu: o aplicativo funciona mesmo sem conexão, e suas mudanças chegam aos outros dispositivos assim que a rede volta.

O projeto é formado por um cliente e por um servidor. O servidor é opcional, mas a documentação o recomenda fortemente, pois ele libera vários recursos:

RecursoSem servidorCom servidor
Orçamentos, relatórios, agendamentosSimSim
Importação de transações a partir de um arquivoSimSim
Importação e exportação de arquivos de orçamentoSimSim
O aplicativo no navegador e no celularSim
A sincronização entre dispositivosSim
A sincronização bancáriaSim
A API do ActualSim

O que a licença MIT permite

O Actual Budget é publicado sob a licença MIT, copyright James Long. O texto concede gratuitamente a qualquer pessoa que obtenha uma cópia o direito de usar, copiar, modificar, fundir, publicar, distribuir, sublicenciar e vender cópias dele.

Há uma condição: o aviso de copyright e o texto da licença acompanham todas as cópias ou partes substanciais do software. Você pode, portanto, rodar a imagem publicada pelo projeto para você, sua família ou sua empresa, sem licença a comprar.

A instalação com Docker Compose

O projeto publica o servidor como imagem Docker, actualbudget/actual-server no Docker Hub, e a mesma imagem no registro do GitHub, ghcr.io/actualbudget/actual. Em um servidor com o Docker instalado, crie uma pasta e coloque nela este compose.yaml, extraído do arquivo fornecido no repositório:

compose.yaml
services:
  actual_server:
    image: docker.io/actualbudget/actual-server:latest
    container_name: actual_server
    restart: unless-stopped
    ports:
      - 127.0.0.1:5006:5006
    volumes:
      - ./actual-data:/data
    healthcheck:
      test: ['CMD-SHELL', 'node scripts/health-check.js']
      interval: 60s
      timeout: 10s
      retries: 3
      start_period: 20s
Terminal
docker compose up -d

Seu nome de domínio aponta para o servidor com registros A e AAAA, e os visitantes chegam pelas portas 80 e 443. Enquanto o HTTPS não estiver no lugar, o aplicativo não abre: passe direto à seção seguinte.

O projeto não informa números de memória nem de processador. O tamanho depende do número de orçamentos, do histórico deles e do número de dispositivos que sincronizam. Em um VPS gerenciado, descreva-nos o uso e recomendamos o tamanho adequado.

O HTTPS: uma condição para o aplicativo iniciar

O Actual Budget se apoia em SharedArrayBuffer, uma tecnologia dos navegadores que a documentação dele descreve como obrigatória: sem ela, o aplicativo não inicia. Os navegadores só a ativam em uma página isolada, o que exige duas condições:

Para expor o Actual na internet, a documentação pede para colocá-lo atrás de um proxy reverso com HTTPS. O servidor também pode servir o HTTPS ele mesmo com um certificado que você fornece, por ACTUAL_HTTPS_KEY e ACTUAL_HTTPS_CERT: a documentação descreve esse caminho para um servidor que fica fora da internet.

Com o Caddy

A documentação apresenta o Caddy como um proxy reverso simples, que obtém e renova sozinho os certificados. Veja o exemplo dela, adaptado a um Caddy instalado no servidor:

Caddyfile
budget.example.com {
    encode gzip zstd
    reverse_proxy 127.0.0.1:5006
}

Com o Nginx e o Certbot

Este bloco retoma a configuração de Nginx da documentação, reduzida à porta 80 para deixar o Certbot instalar o HTTPS. Ele oculta os dois cabeçalhos enviados pelo Actual e os define de novo, uma única vez: a documentação avisa que um cabeçalho duplicado invalida a política, e o aplicativo para então no erro SharedArrayBufferMissing.

Bloco do Nginx
server {
    listen 80;
    listen [::]:80;
    server_name budget.example.com;

    client_max_body_size 0;

    location / {
        proxy_pass http://127.0.0.1:5006;

        proxy_hide_header Cross-Origin-Embedder-Policy;
        proxy_hide_header Cross-Origin-Opener-Policy;

        add_header Cross-Origin-Embedder-Policy "require-corp" always;
        add_header Cross-Origin-Opener-Policy "same-origin" always;
        add_header Origin-Agent-Cluster "?1" always;

        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
        proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    }
}

client_max_body_size 0 retira o limite de tamanho do Nginx, como no exemplo da documentação, para que um arquivo de orçamento grande chegue ao servidor. Em seguida, o Certbot instala o certificado e cuida de renová-lo:

Terminal
sudo certbot --nginx

Verificar

Abra seu endereço em https, em uma nova aba e não recarregando uma página que exibiu um erro, como aconselha a documentação. A tela de boas-vindas do Actual aparece: o HTTPS e os cabeçalhos estão no lugar.

A senha do servidor

Na primeira inicialização, a tela de boas-vindas pede para escolher uma senha para o servidor: é ela que protege o acesso a seus orçamentos. Enquanto nenhuma estiver definida, essa tela aparece para a primeira pessoa que abrir o endereço. Abra-o, portanto, assim que o HTTPS funcionar e escolha uma senha longa, usada só para este servidor.

O servidor guarda essa senha em forma de hash, com argon2, no arquivo account.sqlite de server-files, junto com a lista dos arquivos de orçamento que ele conhece e o token da sessão ativa.

Redefinir uma senha esquecida

A documentação fornece um comando que define uma nova senha sem tocar em seus arquivos nem em seus dados. Ele a pede duas vezes:

Terminal
docker exec -it actual_server node /app/src/scripts/reset-password.js

O OpenID e os vários usuários

Para uma autenticação mais robusta que uma senha, a documentação recomenda um provedor OpenID: a maioria deles oferece a autenticação em duas etapas. É também ele que abre o servidor a vários usuários. A referência de configuração apresenta esse método como uma prévia.

  1. Registre o Actual em seu provedor, com o URI de redirecionamento https://budget.example.com/openid/callback.
  2. Em um orçamento aberto, vá às configurações e clique em Start using OpenID, depois informe o provedor, o ID do cliente e o segredo dele.
  3. Conecte-se com o OpenID. A documentação avisa que a primeira pessoa a se conectar se torna a administradora e a proprietária do servidor, uma função que não pode mais ser alterada pela interface: garanta que você se conecte primeiro.

A mesma configuração também pode ir em config.json ou em variáveis de ambiente, com uma URL de descoberta quando o provedor publica uma:

compose.yaml, no serviço
environment:
  ACTUAL_OPENID_DISCOVERY_URL: "https://auth.example.com/.well-known/openid-configuration"
  ACTUAL_OPENID_CLIENT_ID: "actual"
  ACTUAL_OPENID_CLIENT_SECRET: ${ACTUAL_OPENID_CLIENT_SECRET}
  ACTUAL_OPENID_SERVER_HOSTNAME: "https://budget.example.com"

O segredo vai em um arquivo .env ao lado do compose.yaml. Desde a versão 26.10.0, ACTUAL_OPENID_CLIENT_SECRET_FILE também pode lê-lo em um arquivo, o que convém aos segredos do Docker.

A criptografia de ponta a ponta

Além da senha do servidor, cada orçamento pode ser criptografado de ponta a ponta. Os dados dele são então criptografados em seu dispositivo, com uma chave derivada de uma segunda senha, antes de sair: o servidor só repassa mudanças que não consegue ler.

  1. Abra o orçamento, vá às configurações, seção Encryption, e clique em Enable encryption.
  2. Escolha uma senha diferente da senha do servidor.
  3. Em cada um dos outros dispositivos, informe essa mesma senha uma vez, no primeiro download do orçamento.

A documentação é clara: uma senha de criptografia esquecida não pode ser recuperada. Se ainda existir uma cópia local do orçamento, você pode gerar uma nova chave, o que reinicia a sincronização. A criptografia também não pode ser desativada: voltar a um arquivo não criptografado passa por uma exportação e depois uma importação.

ProteçãoO que ela trazOnde se configura
HTTPSCriptografa o trajeto entre seus dispositivos e o servidor e permite que o aplicativo inicieO proxy reverso
Senha do servidorRestringe o acesso aos orçamentos, com hash argon2 no servidorNa primeira inicialização, depois nas configurações
OpenIDA autenticação em duas etapas de seu provedor e uma conta por pessoaNo provedor, depois nas configurações
Criptografia de ponta a pontaTorna os orçamentos ilegíveis para o servidor e para os backups deleEm cada orçamento
Criptografia do discoProtege a cópia local, que a documentação indica não ser criptografadaEm cada um de seus dispositivos

A criptografia de ponta a ponta cobre os dados dos orçamentos. As credenciais da sincronização bancária ficam no servidor, em account.sqlite, fora dessa criptografia: proteja de acordo o acesso ao servidor e aos backups dele.

A sincronização bancária

O Actual importa suas transações a partir de um arquivo, sem configuração. Ele também sabe buscá-las diretamente em seu banco, por meio de um provedor de dados bancários. Essa sincronização é opcional, exige o servidor e se apoia em suas próprias credenciais: você abre uma conta no provedor e cria ali as chaves que entrega ao Actual. Essas chaves ficam no servidor, e você só as informa uma vez.

ProvedorBancos cobertos, segundo a documentaçãoSituação na versão 26.11.0
SimpleFIN BridgeBancos norte-americanosSuportado; credenciais por orçamento possíveis desde a 26.11.0
GoCardless Bank Account DataBancos europeusSuportado para as contas existentes: a GoCardless não aceita novas contas desde julho de 2025
Pluggy.aiBancos brasileirosSuportado
Enable BankingBancos europeusRecurso experimental
AkahuBancos neozelandesesRecurso experimental

Os backups

Cada dispositivo guarda uma cópia completa de seus orçamentos, e o servidor guarda outra. Um bom backup cobre as duas: a pasta de dados do servidor e uma exportação de cada orçamento.

ElementoO que ele guardaA salvar
server-files/account.sqliteA senha com hash, a lista dos orçamentos, as sessões, as contas OpenID e as credenciais bancáriasObrigatório, criptografado
user-files/Os arquivos de orçamento, em formato binárioObrigatório
config.jsonA configuração do servidor, se você criou umaRecomendado, criptografado
A exportação de cada orçamentoUm arquivo zip com o banco db.sqlite e metadata.jsonRecomendado

A pasta do servidor

Tudo o que o servidor guarda fica em actual-data. Com o servidor parado, ela pode ser copiada de uma vez, com os bancos SQLite em repouso:

Terminal, na pasta do compose.yaml
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d

Agende essa cópia no servidor, criptografe-a e guarde uma em outro lugar. Guardada no disco do servidor, ela também entra nos backups noturnos dele.

A exportação de cada orçamento

A partir de um orçamento aberto: Settings, seção Data, Export data. O arquivo pode ser guardado onde você quiser e abre de novo sem servidor. A documentação usa essa exportação para voltar de um orçamento criptografado a um arquivo não criptografado: ela contém seus dados sem criptografia, por isso guarde-a em lugar seguro.

Um orçamento antigo gera uma exportação grande, pois o Actual guarda cada mudança no arquivo. A documentação aconselha então Reset sync, nas configurações avançadas, antes de exportar: o histórico é compactado em um único arquivo, e o tamanho cai bastante.

Restaurar

  1. Feche o orçamento aberto: clique no nome dele, no alto à esquerda, e depois em Switch file.
  2. Clique em Import file, escolha Actual e depois o arquivo zip da exportação.
  3. O orçamento importado aparece ao lado do original: confira-o, renomeie-o se preciso e exclua a cópia antiga.

Em seus outros dispositivos, escolha então esse orçamento na lista de arquivos: ele é baixado e depois sincroniza. Os aplicativos de desktop também mantêm os próprios backups automáticos, um para cada um dos dez últimos dias de uso e vários para o dia atual.

As atualizações

A documentação dá o comando, a partir da pasta do compose.yaml. A pasta de dados continua no lugar:

Terminal
docker compose pull
docker compose up -d

As versões são numeradas por ano e mês: a 26.11.0 saiu em 1º de novembro de 2026, e as últimas versões foram publicadas no início de cada mês. Leia as notas delas antes de atualizar e exporte seus orçamentos logo antes, como recomenda a documentação. As notas indicam as mudanças a prever, como a lista das redes SimpleFIN autorizadas na 26.11.0, ou a passagem da imagem Ubuntu para o Node.js 24 na 26.9.0, que a tirou dos processadores ARM de 32 bits em favor da imagem Alpine.

Quem faz o quê em um VPS gerenciado

A auto-hospedagem exige cuidar do servidor além da aplicação. Em um VPS gerenciado, nossas equipes assumem o servidor e acompanham sua instância de forma proativa; o Actual Budget continua sendo seu software, com as configurações dele e seus orçamentos.

AssuntoNossas equipesVocê
O servidorAtualizações do sistema e de segurança, com intervenções no servidor incluídasO momento que convém a sua atividade
A supervisãoServidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar sua ligaçãoA leitura dos logs de sua instância
Actual BudgetAcompanhamento proativo: erros, lentidões e espaço em disco identificados, correção recomendadaA instalação, as atualizações e as configurações dele, que você aplica, por conta própria ou com seu assistente de IA
Os acessos e os orçamentosO servidor que os sustenta, monitorado e com backupA senha do servidor, o OpenID, os usuários e a criptografia de ponta a ponta
A sincronização bancáriaO servidor que guarda as credenciais dela, monitorado e com backupA escolha do provedor, as chaves dele e as contas vinculadas
Os backupsToda noite, criptografados e guardados fora da máquina; restauração incluídaAs exportações de seus orçamentos e o pedido de restauração, quando você precisar
A migraçãoSeu servidor atual migrado, grátisO momento da virada

Se você preferir que nossas equipes intervenham na própria aplicação, esse serviço é cobrado por hora ou por valor fechado, com o orçamento informado antes da intervenção.

Actual Budget, em um servidor cuidado por nós

Com um VPS gerenciado Simafri, nossas equipes mantêm atualizado o servidor de sua instância Actual Budget, monitoram-no dia e noite e intervêm sem esperar sua ligação; elas também acompanham sua instância de forma proativa e recomendam as correções úteis, que você aplica por conta própria ou com seu assistente de IA. Os backups são criptografados todas as noites e guardados fora da máquina, a restauração está incluída, e a migração de seu servidor atual é grátis.

Conhecer os VPS gerenciados

Perguntas frequentes

O Actual Budget é gratuito?

Sim. O Actual Budget é publicado sob a licença MIT: você pode usá-lo, modificá-lo e redistribuí-lo livremente, para você ou para uma empresa, desde que o aviso de copyright e de licença dele permaneça nas cópias. Resta o custo do servidor em que ele roda.

É preciso um servidor para usar o Actual Budget?

Os aplicativos de desktop funcionam sozinhos. O servidor, que a documentação recomenda fortemente, acrescenta o aplicativo web e móvel, a sincronização entre dispositivos, a sincronização bancária e a API. Cada dispositivo guarda uma cópia completa de seus orçamentos, sincronizada com o servidor.

Como instalar o Actual Budget com Docker Compose?

Crie um compose.yaml com a imagem actualbudget/actual-server, a porta 5006 publicada em 127.0.0.1 e uma pasta de dados montada em /data e execute docker compose up -d. Coloque então na frente um proxy reverso em HTTPS e abra seu endereço para escolher a senha do servidor.

Por que o Actual Budget exige HTTPS?

O aplicativo precisa de SharedArrayBuffer, que os navegadores só ativam em uma página servida em HTTPS com os cabeçalhos Cross-Origin-Embedder-Policy e Cross-Origin-Opener-Policy. O servidor define esses cabeçalhos; o proxy reverso traz o HTTPS. Só o acesso por localhost dispensa isso.

Como proteger os dados de um orçamento do Actual?

Sirva a instância em HTTPS, escolha uma senha do servidor forte ou use o OpenID com a autenticação em duas etapas e ative a criptografia de ponta a ponta: o servidor deixa de conseguir ler seus orçamentos. Guarde essa segunda senha em lugar seguro, pois ela não pode ser recuperada.

O Actual Budget se conecta a meu banco?

Sim, por meio de um provedor de dados bancários, com suas próprias credenciais: SimpleFIN Bridge, GoCardless Bank Account Data para as contas existentes, Pluggy.ai, e Enable Banking e Akahu como recursos experimentais. A sincronização exige o servidor e pode rodar automaticamente desde a versão 26.11.0.

Como fazer backup do Actual Budget?

Copie a pasta de dados do servidor com o servidor parado: server-files guarda as contas e as credenciais, user-files os orçamentos. Exporte também cada orçamento em Settings, Export data, e guarde essas cópias criptografadas. Uma exportação é restaurada com Import file.

Um VPS gerenciado cobre o Actual Budget?

Um VPS gerenciado cobre o servidor: sistema, segurança, supervisão e backups. Nossas equipes também acompanham sua instância de forma proativa e recomendam as correções úteis, que você aplica. Uma intervenção na aplicação é cobrada por hora ou por valor fechado.

Fontes e documentação oficial

Guias relacionados

Diferença entre VPS gerenciado e não gerenciado: quem faz o quêA diferença entre um VPS gerenciado e um VPS não gerenciado se resume a uma pergunta: quem cuida do servidor depois que ele está no ar. A palavra “gerenciado”, porém, não tem definição oficial: de um provedor para outro, ela vai de uma simples instalação do sistema até a operação completa do servidor. Este guia mostra quem faz o quê, linha por linha, incluindo o nível intermediário da assistência, e traz as perguntas que tiram a dúvida antes de assinar.Backup de VPS: o que verificar antes de contratarUma oferta de VPS quase sempre anuncia “backup incluído”. Por trás dessas duas palavras, pode haver uma cópia toda noite, guardada fora da máquina e restaurada por especialistas, ou um snapshot no mesmo disco do servidor. Este guia traz as perguntas que fazem a diferença, o que cada resposta quer dizer e como verificar que um backup realmente se restaura.Hospedar Vaultwarden em um VPS gerenciado: suas senhas em seu servidorHospedar o Vaultwarden em um VPS gerenciado é guardar suas senhas e as de sua equipe em uma máquina própria, que nossas equipes mantêm atualizada e supervisionam dia e noite. O Vaultwarden é um software livre sob a licença AGPL-3.0. Este guia segue a documentação oficial dele: a instalação com Docker Compose, o HTTPS, o fechamento dos cadastros, o token de administração, o que protege o cofre, o banco de dados, os e-mails, os backups e as atualizações.
Entre em contato