Alojar Actual Budget num VPS gerido: os seus orçamentos no seu servidor

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.

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

Todos os guias

O essencial

  1. A licença MIT permite utilizar, modificar e redistribuir livremente o Actual Budget, desde que o seu aviso de direitos de autor e de licença acompanhe as cópias.
  2. O servidor sincroniza os seus orçamentos entre os seus dispositivos e serve a aplicação web: instale-o com o Docker Compose, uma imagem e uma pasta de dados.
  3. O HTTPS é indispensável: a aplicação precisa de SharedArrayBuffer, que os navegadores só ativam numa página servida em HTTPS. Um proxy inverso trata disso.
  4. Abra o seu endereço logo no primeiro arranque do servidor para escolher a palavra-passe do servidor. O OpenID acrescenta a autenticação de dois fatores do seu fornecedor e vários utilizadores.
  5. A cifragem de ponta a ponta, facultativa, torna os seus orçamentos ilegíveis para o servidor. Faça a cópia da pasta de dados e exporte os seus orçamentos, e atualize depois com docker compose pull.

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

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:

FuncionalidadeSem servidorCom servidor
Orçamentos, relatórios, agendamentosSimSim
Importação de transações a partir de um ficheiroSimSim
Importação e exportação de ficheiros de orçamentoSimSim
A aplicação num navegador e num telemóvelSim
A sincronização entre dispositivosSim
A sincronização bancáriaSim
A API do ActualSim

O que permite a licença MIT

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.

A instalação com o Docker Compose

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:

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

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.

HTTPS: uma condição para a aplicação arrancar

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:

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.

Com o Caddy

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:

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 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.

Bloco 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 ficheiro de orçamento grande chegue ao servidor. O Certbot instala depois o certificado e encarrega-se de o renovar:

Terminal
sudo certbot --nginx

Verificar

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.

A palavra-passe do servidor

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.

Repor uma palavra-passe esquecida

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:

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

O OpenID e vários utilizadores

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.

  1. Registe o Actual no seu fornecedor, com o URI de redirecionamento https://budget.example.com/openid/callback.
  2. Num orçamento aberto, vá às definições e clique em Start using OpenID, e preencha depois o fornecedor, o identificador do cliente e o respetivo segredo.
  3. Inicie sessão com o OpenID. A documentação avisa que a primeira pessoa a iniciar sessão se torna administradora e proprietária do servidor, uma função que deixa de poder ser alterada a partir da interface: certifique-se de que é o primeiro a iniciar sessão.

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:

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 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.

A cifragem de ponta a ponta

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.

  1. Abra o orçamento, vá às definições, secção Encryption, e clique em Enable encryption.
  2. Escolha uma palavra-passe diferente da palavra-passe do servidor.
  3. Em cada um dos outros dispositivos, introduza uma vez esta mesma palavra-passe, na primeira transferência do orçamento.

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çãoO que trazOnde se define
HTTPSCifra o trajeto entre os seus dispositivos e o servidor, e permite que a aplicação arranqueO proxy inverso
Palavra-passe do servidorLimita o acesso aos orçamentos, guardada com hash argon2 no servidorNo primeiro arranque, e depois nas definições
OpenIDA autenticação de dois fatores do seu fornecedor, e uma conta por pessoaNo fornecedor, e depois nas definições
Cifragem de ponta a pontaTorna os orçamentos ilegíveis para o servidor e para as suas cópias de segurançaEm cada orçamento
Cifragem do discoProtege a cópia local, que a documentação assinala não ser cifradaEm 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.

A sincronização bancária

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.

FornecedorBancos cobertos, segundo a documentaçãoEstado 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 deixou de aceitar novas contas desde julho de 2025
Pluggy.aiBancos brasileirosSuportado
Enable BankingBancos europeusFuncionalidade experimental
AkahuBancos neozelandesesFuncionalidade experimental

As cópias de segurança

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.

ElementoO que guardaA copiar
server-files/account.sqliteA palavra-passe com hash, a lista dos orçamentos, as sessões, as contas OpenID e as credenciais bancáriasObrigatório, cifrado
user-files/Os ficheiros de orçamento, em formato binárioObrigatório
config.jsonA configuração do servidor, se a tiver criadoRecomendado, cifrado
A exportação de cada orçamentoUm ficheiro zip com a base de dados db.sqlite e metadata.jsonRecomendado

A pasta do servidor

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:

Terminal, na pasta do compose.yaml
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 exportação de cada orçamento

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.

Restaurar

  1. Feche o orçamento aberto: clique no seu nome, em cima à esquerda, e depois em Switch file.
  2. Clique em Import file, escolha Actual e depois o ficheiro zip da exportação.
  3. O orçamento importado aparece ao lado do original: verifique-o, mude-lhe o nome se necessário e elimine depois a cópia antiga.

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.

As atualizações

A documentação dá o comando, a partir da pasta do compose.yaml. A pasta de dados mantém-se 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 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.

Quem faz o quê num VPS gerido

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.

AssuntoAs nossas equipasVocê
O servidorAtualizações do sistema e de segurança, intervenções no servidor incluídasO momento que convém à sua atividade
A supervisãoServidor acompanhado 24 horas por dia, 7 dias por semana, com intervenção sem esperar pela sua chamadaA leitura dos registos da sua instância
Actual BudgetAcompanhamento proativo: erros, lentidão e espaço em disco identificados, correção recomendadaA 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çamentosO servidor que os suporta, vigiado e com cópias de segurançaA palavra-passe do servidor, o OpenID, os utilizadores e a cifragem de ponta a ponta
A sincronização bancáriaO servidor que guarda as suas credenciais, vigiado e com cópias de segurançaA escolha do fornecedor, as suas chaves e as contas ligadas
As cópias de segurançaTodas as noites, cifradas e guardadas fora da máquina; restauro incluídoAs exportações dos seus orçamentos e o pedido de restauro, quando precisar
A migraçãoO seu servidor atual migrado, oferecidoO 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.

O Actual Budget, num servidor mantido por si

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.

Descobrir os VPS geridos

Perguntas frequentes

O Actual Budget é gratuito?

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.

É preciso um servidor para utilizar o Actual Budget?

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.

Como instalar o Actual Budget com o 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 depois um proxy inverso em HTTPS à frente e abra o seu endereço para escolher a palavra-passe do servidor.

Porque é que o Actual Budget exige HTTPS?

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.

Como proteger os dados de um orçamento Actual?

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.

O Actual Budget liga-se ao meu banco?

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.

Como fazer a cópia de segurança do Actual Budget?

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 Actual Budget?

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.

Fontes e documentação oficial

Guias relacionados

Diferença entre VPS gerido e não gerido: quem faz o quêA diferença entre um VPS gerido e um VPS não gerido resume-se a uma pergunta: quem trata do servidor depois de ele estar a funcionar. No entanto, «gerido» não tem definição oficial e, de um fornecedor de alojamento para outro, a palavra vai da simples instalação do sistema à exploração completa do servidor. Este guia mostra quem faz o quê, linha a linha, com o nível intermédio da assistência, e dá as perguntas que eliminam a ambiguidade antes de assinar.Backups de um VPS: o que verificar antes de contratarUma oferta de VPS anuncia quase sempre «cópias de segurança incluídas». Por trás destas palavras pode haver uma cópia todas as noites, guardada fora da máquina e restaurada por especialistas, ou um instantâneo colocado no mesmo disco que o servidor. Este guia dá as perguntas que fazem a diferença, o que cada resposta quer dizer, e a forma de verificar que uma cópia de segurança se restaura.Alojar Vaultwarden num VPS gerido: as suas palavras-passe no seu servidorAlojar Vaultwarden num VPS gerido é guardar as suas palavras-passe e as da sua equipa numa máquina sua, que as nossas equipas mantêm atualizada e supervisionam dia e noite. O Vaultwarden é um software livre sob licença AGPL-3.0. Este guia segue a sua documentação oficial: a instalação com o Docker Compose, o HTTPS, o encerramento das inscrições, o token de administração, o que protege o cofre, a base de dados, os e-mails, as cópias de segurança e as atualizações.
Contacte-nos