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.
Por Simon Vasconcelos Lee
Publicado em 17 de novembro de 2026Leitura: 14 minutos
SharedArrayBuffer, que os navegadores só ativam em uma página servida em HTTPS. Um proxy reverso cuida disso.docker compose pull.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:
| Recurso | Sem servidor | Com servidor |
|---|---|---|
| Orçamentos, relatórios, agendamentos | Sim | Sim |
| Importação de transações a partir de um arquivo | Sim | Sim |
| Importação e exportação de arquivos de orçamento | Sim | Sim |
| O aplicativo no navegador e no celular | Sim | |
| A sincronização entre dispositivos | Sim | |
| A sincronização bancária | Sim | |
| A API do Actual | Sim |
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.
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:
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
docker compose up -d
127.0.0.1, ela só é acessada pelo proxy reverso do mesmo servidor, que acrescenta o HTTPS.actual-data guarda tudo o que o servidor mantém. Ele cria nela duas subpastas, server-files e user-files, e a documentação lembra que essa montagem preserva seus dados quando o contêiner é removido.latest acompanha a versão oficial mais recente, e a documentação a recomenda para a maioria dos usuários. latest-alpine dá a mesma versão em uma base Alpine mais leve, e uma tag como 26.11.0 fixa uma versão. As tags nightly acompanham o desenvolvimento, a cada mudança no branch principal dele.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 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:
localhost.Cross-Origin-Embedder-Policy com o valor require-corp e Cross-Origin-Opener-Policy com o valor same-origin. O servidor oficial sempre os define ele mesmo.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.
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:
budget.example.com {
encode gzip zstd
reverse_proxy 127.0.0.1:5006
}
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.
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:
sudo certbot --nginx
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.
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.
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:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: password por padrão, openid para um provedor de identidade, ou header.x-actual-password. A documentação avisa que um erro de configuração nessa etapa poderia deixar a instância disponível para a internet inteira: reserve-o a esses serviços.ACTUAL_ALLOWED_LOGIN_METHODS, uma lista separada por vírgulas.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.
https://budget.example.com/openid/callback.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:
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.
"authMethod": "oauth2", em config.json.ACTUAL_USER_CREATION_MODE com o valor login os cria no primeiro login.ACTUAL_OPENID_ENFORCE com o valor true faz dele o único método de login aceito.ACTUAL_TOKEN_EXPIRATION vale never por padrão. Ela pode seguir a do provedor, com openid-provider, ou uma duração em segundos.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.
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ção | O que ela traz | Onde se configura |
|---|---|---|
| HTTPS | Criptografa o trajeto entre seus dispositivos e o servidor e permite que o aplicativo inicie | O proxy reverso |
| Senha do servidor | Restringe o acesso aos orçamentos, com hash argon2 no servidor | Na primeira inicialização, depois nas configurações |
| OpenID | A autenticação em duas etapas de seu provedor e uma conta por pessoa | No provedor, depois nas configurações |
| Criptografia de ponta a ponta | Torna os orçamentos ilegíveis para o servidor e para os backups dele | Em cada orçamento |
| Criptografia do disco | Protege a cópia local, que a documentação indica não ser criptografada | Em 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.
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.
| Provedor | Bancos cobertos, segundo a documentação | Situação na versão 26.11.0 |
|---|---|---|
| SimpleFIN Bridge | Bancos norte-americanos | Suportado; credenciais por orçamento possíveis desde a 26.11.0 |
| GoCardless Bank Account Data | Bancos europeus | Suportado para as contas existentes: a GoCardless não aceita novas contas desde julho de 2025 |
| Pluggy.ai | Bancos brasileiros | Suportado |
| Enable Banking | Bancos europeus | Recurso experimental |
| Akahu | Bancos neozelandeses | Recurso experimental |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. As pontes SimpleFIN públicas não exigem nenhuma configuração.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.
| Elemento | O que ele guarda | A salvar |
|---|---|---|
server-files/account.sqlite | A senha com hash, a lista dos orçamentos, as sessões, as contas OpenID e as credenciais bancárias | Obrigatório, criptografado |
user-files/ | Os arquivos de orçamento, em formato binário | Obrigatório |
config.json | A configuração do servidor, se você criou uma | Recomendado, criptografado |
| A exportação de cada orçamento | Um arquivo zip com o banco db.sqlite e metadata.json | Recomendado |
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:
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 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.
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.
A documentação dá o comando, a partir da pasta do compose.yaml. A pasta de dados continua no lugar:
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.
nightly: voltar de nightly para latest pode deixar um orçamento ilegível para a versão estável. A documentação descreve a correção e pede backups de seus orçamentos com essas tags.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.
| Assunto | Nossas equipes | Você |
|---|---|---|
| O servidor | Atualizações do sistema e de segurança, com intervenções no servidor incluídas | O momento que convém a sua atividade |
| A supervisão | Servidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar sua ligação | A leitura dos logs de sua instância |
| Actual Budget | Acompanhamento proativo: erros, lentidões e espaço em disco identificados, correção recomendada | A 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çamentos | O servidor que os sustenta, monitorado e com backup | A senha do servidor, o OpenID, os usuários e a criptografia de ponta a ponta |
| A sincronização bancária | O servidor que guarda as credenciais dela, monitorado e com backup | A escolha do provedor, as chaves dele e as contas vinculadas |
| Os backups | Toda noite, criptografados e guardados fora da máquina; restauração incluída | As exportações de seus orçamentos e o pedido de restauração, quando você precisar |
| A migração | Seu servidor atual migrado, grátis | O 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.
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.
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.
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.
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.
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.
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.
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.
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 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.
Simafri
Vamos falar de seu site
Conte para a gente sobre seu projeto em poucas palavras: responderemos rapidamente.
Obrigado! O seu pedido foi enviado. Responderemos em breve.
Prefere o e-mail? Escreva para a gente em support@simafri.com.