Alojar Actual Budget num VPS gerido é guardar os seus orçamentos e a respetiva sincronização numa máquina sua, que as nossas equipas mantêm atualizada e supervisionam dia e noite. O Actual Budget é uma ferramenta de finanças pessoais que trabalha primeiro em local, publicada sob licença MIT. Este guia segue a sua documentação oficial: o papel do servidor, a instalação com o Docker Compose, o HTTPS, a palavra-passe do servidor, o OpenID, a cifragem de ponta a ponta, a sincronização bancária, as cópias de segurança e as atualizações.
Por Simon Vasconcelos Lee
Publicado a 17 de novembro de 2026Leitura: 14 minutos
SharedArrayBuffer, que os navegadores só ativam numa página servida em HTTPS. Um proxy inverso trata disso.docker compose pull.O Actual Budget é uma ferramenta de finanças pessoais que trabalha primeiro em local, escrita em Node.js, que o seu README descreve como inteiramente gratuita e de código aberto. Guarda todos os seus dados em cada um dos seus dispositivos e sincroniza-os em segundo plano com o servidor que escolheu: a aplicação funciona mesmo sem ligação, e as suas alterações chegam aos seus outros dispositivos assim que a rede volta.
O projeto é composto por um cliente e um servidor. O servidor é facultativo, mas a documentação recomenda-o vivamente, porque desbloqueia várias funcionalidades:
| Funcionalidade | Sem servidor | Com servidor |
|---|---|---|
| Orçamentos, relatórios, agendamentos | Sim | Sim |
| Importação de transações a partir de um ficheiro | Sim | Sim |
| Importação e exportação de ficheiros de orçamento | Sim | Sim |
| A aplicação num navegador e num telemóvel | 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, com direitos de autor de James Long. O texto concede a qualquer pessoa que obtenha uma cópia, gratuitamente, o direito de a utilizar, copiar, modificar, fundir, publicar, distribuir, sublicenciar e vender cópias.
Há uma condição: o aviso de direitos de autor e o texto da licença acompanham todas as cópias ou partes substanciais do software. Pode, portanto, fazer correr a imagem publicada pelo projeto para si, para a sua família ou para a sua empresa, sem licença para comprar.
O projeto publica o servidor como imagem Docker, actualbudget/actual-server no Docker Hub, e a mesma imagem no registo do GitHub, ghcr.io/actualbudget/actual. Num servidor com o Docker instalado, crie uma pasta e coloque nela este compose.yaml, tirado do ficheiro 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, só é acessível através do proxy inverso do mesmo servidor, que acrescenta o HTTPS.actual-data guarda tudo o que o servidor conserva. Este cria nela duas subpastas, server-files e user-files, e a documentação assinala que esta montagem conserva os seus dados quando o contentor é eliminado.latest acompanha a versão oficial mais recente, e a documentação recomenda-a à maioria dos utilizadores. latest-alpine dá a mesma versão numa base Alpine mais leve, e uma etiqueta como 26.11.0 fixa uma versão. As etiquetas nightly acompanham o desenvolvimento, a cada alteração do seu ramo principal.O seu nome de domínio aponta para o servidor com registos A e AAAA, e os visitantes chegam pelas portas 80 e 443. Enquanto o HTTPS não estiver instalado, a aplicação não abre: passe diretamente à secção seguinte.
O projeto não indica nenhum valor de memória nem de processador. O tamanho depende do número de orçamentos, do seu histórico e do número de dispositivos que sincronizam. Num VPS gerido, descreva-nos a sua utilização e recomendamos-lhe o tamanho adequado.
O Actual Budget assenta em SharedArrayBuffer, uma tecnologia dos navegadores que a sua documentação descreve como obrigatória: sem ela, a aplicação não arranca. Os navegadores só a ativam numa 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 define-os sempre ele próprio.Para expor o Actual à internet, a documentação pede que o coloque atrás de um proxy inverso com HTTPS. O servidor pode também servir ele próprio o HTTPS com um certificado que lhe forneça, através de ACTUAL_HTTPS_KEY e ACTUAL_HTTPS_CERT: a documentação descreve esta via para um servidor que fica fora da internet.
A documentação apresenta o Caddy como um proxy inverso simples, que obtém e renova sozinho os seus certificados. Eis o seu exemplo, 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 Nginx da documentação, reduzida à porta 80 para deixar o Certbot instalar o HTTPS. Oculta os dois cabeçalhos enviados pelo Actual e volta a defini-los, uma única vez: a documentação avisa que um cabeçalho duplicado invalida a política, e a aplicação 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 ficheiro de orçamento grande chegue ao servidor. O Certbot instala depois o certificado e encarrega-se de o renovar:
sudo certbot --nginx
Abra o seu endereço em https, num novo separador em vez de recarregar uma página que mostrou um erro, como aconselha a documentação. Aparece o ecrã de boas-vindas do Actual: o HTTPS e os cabeçalhos estão no lugar.
No primeiro arranque, o ecrã de boas-vindas pede que escolha uma palavra-passe para o servidor: é ela que protege o acesso aos seus orçamentos. Enquanto não estiver definida, este ecrã aparece à primeira pessoa que abrir o endereço. Abra-o, portanto, assim que o HTTPS funcionar e escolha uma palavra-passe longa, utilizada apenas neste servidor.
O servidor guarda esta palavra-passe em forma de hash, com argon2, no ficheiro account.sqlite de server-files, juntamente com a lista dos ficheiros de orçamento que conhece e o token da sessão ativa.
A documentação fornece um comando que define uma nova palavra-passe sem tocar nos seus ficheiros nem nos seus dados. Pede-a duas vezes:
docker exec -it actual_server node /app/src/scripts/reset-password.js
ACTUAL_LOGIN_METHOD: password por predefinição, openid para um fornecedor de identidade, ou header.x-actual-password. A documentação avisa que uma configuração errada nesta etapa poderia tornar a instância acessível a toda a internet: reserve-o a esses serviços.ACTUAL_ALLOWED_LOGIN_METHODS, uma lista separada por vírgulas.Para uma autenticação mais robusta do que uma palavra-passe, a documentação recomenda um fornecedor OpenID: a maioria oferece a autenticação de dois fatores. É também o que abre o servidor a vários utilizadores. A referência de configuração apresenta este método como uma pré-visualização.
https://budget.example.com/openid/callback.A mesma configuração pode também ir para config.json ou para variáveis de ambiente, com um URL de descoberta quando o fornecedor publica um:
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 fica num ficheiro .env ao lado do compose.yaml. Desde a versão 26.10.0, ACTUAL_OPENID_CLIENT_SECRET_FILE pode também lê-lo a partir de um ficheiro, o que convém aos segredos Docker.
"authMethod": "oauth2", em config.json.ACTUAL_USER_CREATION_MODE com o valor login cria-os no primeiro início de sessão.ACTUAL_OPENID_ENFORCE com o valor true torna-o o único método de início de sessão aceite.ACTUAL_TOKEN_EXPIRATION vale never por predefinição. Pode seguir a do fornecedor, com openid-provider, ou uma duração em segundos.Para além da palavra-passe do servidor, cada orçamento pode ser cifrado de ponta a ponta. Os seus dados são então cifrados no seu dispositivo, com uma chave derivada de uma segunda palavra-passe, antes de saírem: o servidor só transmite alterações que não consegue ler.
A documentação é clara: uma palavra-passe de cifragem esquecida não pode ser recuperada. Se ainda existir uma cópia local do orçamento, pode gerar uma nova chave, o que reinicia a sincronização. A cifragem também não pode ser desativada: voltar a um ficheiro não cifrado passa por uma exportação e depois por uma importação.
| Proteção | O que traz | Onde se define |
|---|---|---|
| HTTPS | Cifra o trajeto entre os seus dispositivos e o servidor, e permite que a aplicação arranque | O proxy inverso |
| Palavra-passe do servidor | Limita o acesso aos orçamentos, guardada com hash argon2 no servidor | No primeiro arranque, e depois nas definições |
| OpenID | A autenticação de dois fatores do seu fornecedor, e uma conta por pessoa | No fornecedor, e depois nas definições |
| Cifragem de ponta a ponta | Torna os orçamentos ilegíveis para o servidor e para as suas cópias de segurança | Em cada orçamento |
| Cifragem do disco | Protege a cópia local, que a documentação assinala não ser cifrada | Em cada um dos seus dispositivos |
A cifragem de ponta a ponta cobre os dados dos orçamentos. As credenciais da sincronização bancária são guardadas no servidor, em account.sqlite, fora desta cifragem: proteja em conformidade o acesso ao servidor e às suas cópias de segurança.
O Actual importa as suas transações a partir de um ficheiro, sem nenhuma configuração. Pode também ir buscá-las diretamente ao seu banco, através de um fornecedor de dados bancários. Esta sincronização é facultativa, exige o servidor e assenta nas suas próprias credenciais: abre uma conta no fornecedor e cria nela as chaves que fornece ao Actual. Estas chaves ficam guardadas no servidor, e só as introduz uma vez.
| Fornecedor | Bancos cobertos, segundo a documentação | Estado 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 deixou de aceitar novas contas desde julho de 2025 |
| Pluggy.ai | Bancos brasileiros | Suportado |
| Enable Banking | Bancos europeus | Funcionalidade experimental |
| Akahu | Bancos neozelandeses | Funcionalidade experimental |
ACTUAL_SIMPLEFIN_ALLOWED_NETWORKS. As pontes SimpleFIN públicas não exigem nenhuma definição.Cada dispositivo guarda uma cópia completa dos seus orçamentos, e o servidor guarda outra. Uma boa cópia de segurança cobre ambas: a pasta de dados do servidor e uma exportação de cada orçamento.
| Elemento | O que guarda | A copiar |
|---|---|---|
server-files/account.sqlite | A palavra-passe com hash, a lista dos orçamentos, as sessões, as contas OpenID e as credenciais bancárias | Obrigatório, cifrado |
user-files/ | Os ficheiros de orçamento, em formato binário | Obrigatório |
config.json | A configuração do servidor, se a tiver criado | Recomendado, cifrado |
| A exportação de cada orçamento | Um ficheiro zip com a base de dados db.sqlite e metadata.json | Recomendado |
Tudo o que o servidor guarda vive em actual-data. Com o servidor parado, copia-se de uma só vez, com as suas bases de dados SQLite em repouso:
docker compose down
tar -czf actual-$(date +%F).tar.gz actual-data
docker compose up -d
Agende esta cópia no servidor, cifre-a e guarde uma noutro lugar. Colocada no disco do servidor, entra também nas suas cópias de segurança noturnas.
A partir de um orçamento aberto: Settings, secção Data, Export data. O ficheiro pode ser guardado onde quiser e volta a abrir-se sem servidor. A documentação utiliza esta exportação para passar de um orçamento cifrado a um ficheiro não cifrado: contém os seus dados em claro, por isso guarde-a num lugar seguro.
Um orçamento antigo dá uma exportação volumosa, porque o Actual guarda no ficheiro todas as alterações. A documentação aconselha então Reset sync, nas definições avançadas, antes de exportar: o histórico é compactado num único ficheiro, e o tamanho diminui muito.
Nos seus outros dispositivos, escolha depois este orçamento na lista dos ficheiros: é transferido e depois sincronizado. As aplicações de computador mantêm também as suas próprias cópias de segurança automáticas, uma por cada um dos últimos dez dias de utilização, e várias para o dia atual.
A documentação dá o comando, a partir da pasta do compose.yaml. A pasta de dados mantém-se 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 a 1 de novembro de 2026, e as últimas versões foram publicadas no início de cada mês. Leia as respetivas notas antes de atualizar e exporte os seus orçamentos logo antes, como recomenda a documentação. As notas assinalam as alterações 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 retirou 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 cópias de segurança dos seus orçamentos com estas etiquetas.O autoalojamento exige cuidar do servidor para além da aplicação. Num VPS gerido, as nossas equipas assumem o servidor e acompanham a sua instância de forma proativa; o Actual Budget continua a ser o seu software, com as suas definições e os seus orçamentos.
| Assunto | As nossas equipas | Você |
|---|---|---|
| O servidor | Atualizações do sistema e de segurança, intervenções no servidor incluídas | O momento que convém à sua atividade |
| A supervisão | Servidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar pela sua chamada | A leitura dos registos da sua instância |
| Actual Budget | Acompanhamento proativo: erros, lentidão e espaço em disco identificados, correção recomendada | A sua instalação, as suas atualizações e as suas definições, que aplica diretamente ou com o seu assistente de IA |
| Os acessos e os orçamentos | O servidor que os suporta, vigiado e com cópias de segurança | A palavra-passe do servidor, o OpenID, os utilizadores e a cifragem de ponta a ponta |
| A sincronização bancária | O servidor que guarda as suas credenciais, vigiado e com cópias de segurança | A escolha do fornecedor, as suas chaves e as contas ligadas |
| As cópias de segurança | Todas as noites, cifradas e guardadas fora da máquina; restauro incluído | As exportações dos seus orçamentos e o pedido de restauro, quando precisar |
| A migração | O seu servidor atual migrado, oferecido | O momento da mudança |
Se preferir que as nossas equipas intervenham na própria aplicação, este serviço é faturado à hora ou por pacote, com um orçamento comunicado antes da intervenção.
Com um VPS gerido da Simafri, as nossas equipas mantêm atualizado o servidor da sua instância Actual Budget, vigiam-no dia e noite e intervêm sem esperar pela sua chamada; acompanham também a sua instância de forma proativa e recomendam-lhe as correções úteis, que aplica diretamente ou com o seu assistente de IA. As cópias de segurança são cifradas todas as noites e guardadas fora da máquina, o seu restauro está incluído, e a migração do seu servidor atual é oferecida.
Sim. O Actual Budget é publicado sob licença MIT: pode utilizá-lo, modificá-lo e redistribuí-lo livremente, para si ou para uma empresa, desde que o seu aviso de direitos de autor e de licença acompanhe as cópias. Resta o custo do servidor que o faz funcionar.
As aplicações de computador funcionam sozinhas. O servidor, que a documentação recomenda vivamente, acrescenta a aplicação web e móvel, a sincronização entre dispositivos, a sincronização bancária e a API. Cada dispositivo guarda uma cópia completa dos 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 depois um proxy inverso em HTTPS à frente e abra o seu endereço para escolher a palavra-passe do servidor.
A aplicação precisa de SharedArrayBuffer, que os navegadores só ativam numa página servida em HTTPS com os cabeçalhos Cross-Origin-Embedder-Policy e Cross-Origin-Opener-Policy. O servidor define estes cabeçalhos; o proxy inverso traz o HTTPS. Só o acesso por localhost o dispensa.
Sirva a instância em HTTPS, escolha uma palavra-passe do servidor sólida ou utilize o OpenID com autenticação de dois fatores, e ative a cifragem de ponta a ponta: o servidor deixa de conseguir ler os seus orçamentos. Guarde essa segunda palavra-passe num lugar seguro, porque não pode ser recuperada.
Sim, através de um fornecedor de dados bancários, com as suas próprias credenciais: SimpleFIN Bridge, GoCardless Bank Account Data para as contas existentes, Pluggy.ai, e Enable Banking e Akahu como funcionalidades experimentais. A sincronização exige o servidor e pode correr automaticamente desde a versão 26.11.0.
Copie a pasta de dados do servidor com o servidor parado: server-files contém as contas e as credenciais, user-files os orçamentos. Exporte também cada orçamento a partir de Settings, Export data, e guarde estas cópias cifradas. Uma exportação restaura-se com Import file.
Um VPS gerido cobre o servidor: sistema, segurança, supervisão e cópias de segurança. As nossas equipas acompanham também a sua instância de forma proativa e recomendam-lhe as correções úteis, que aplica. Uma intervenção na aplicação é faturada à hora ou por pacote.
Simafri
Vamos falar do seu projeto
Diga-nos em poucas palavras o que precisa: respondemos-lhe rapidamente.
Obrigado! O seu pedido foi enviado. Responderemos em breve.
Prefere o email? Escreva-nos para support@simafri.com.