Controle suas finanças.
Sem entregar seus dados.

O ContaBase organiza as contas da sua casa e do seu negócio: receitas, despesas, orçamentos e relatórios, rodando no seu próprio servidor. Os dados do app ficam na sua instalação, sem telemetria ou envio para terceiros, e o código é aberto para auditoria.

Ver como instalar Ver o projeto

Canal Beta público. Ainda não existe release Stable pública. Ver releases.

Instalação rápida

curl -fsSLo /tmp/contabase-install.sh https://get-contabase.pages.dev/beta/install.sh && bash /tmp/contabase-install.sh

Se não estiver como root, use sudo bash /tmp/contabase-install.sh.

Sem cadastro em nuvem Backup sob seu controle Multiusuário

Privacidade por padrãoO app não envia telemetria

Self-hostedRoda no seu servidor, VPS ou LXC

Licença AGPL-3.0Código aberto e auditável

Deploy com DockerInstalador guiado para Docker, VPS ou LXC

Recursos

Feito para a vida real: casa, família e negócio

Uma base única de contas e categorias que serve tanto para o orçamento doméstico quanto para o fluxo de caixa de uma pequena empresa, sem planilhas paralelas.

Privacidade em primeiro lugar

O app não depende de serviços externos, não envia telemetria e não exige conta em nuvem. Seus dados ficam no banco que você controla.

App sem telemetria
SQLite no seu volume
Exportação e backup do banco

Contas e transações

Receitas, despesas e transferências entre contas, com categorias e conciliação mensal.

Orçamentos que funcionam

Defina limites por categoria e acompanhe o quanto já foi gasto antes do mês acabar.

Família e multiusuário

Cada pessoa com seu acesso, permissões separadas e uma visão consolidada do orçamento da casa.

Workspaces

Separe a vida pessoal e o negócio em ambientes Pessoal e Business, com dados e contexto próprios.

Para pequenas empresas

Fluxo de caixa, contas a pagar e receber, e relatórios gerenciais, sem a complexidade de um ERP.

Seus dados, exportáveis

Exportação do banco em .db e backup do diretório de dados. Sem prisão de dados.

Telas do sistema

Veja como é por dentro

Demonstração parcial com dados fictícios: não é a versão completa e nem tudo funciona. Escolha desktop ou mobile e explore as telas.

contabase.local / demo / painel Painel

Demonstração estática com dados fictícios. Nenhuma operação financeira é executada; formulários e ações estão desabilitados.

A demonstração interativa requer JavaScript. Você pode abrir a versão estática do painel ou consultar as capturas em desktop e mobile.

Instalação

Canais de instalação

A Beta é o canal público disponível hoje. A Stable será aberta quando a release cumprir os gates de publicação.

Antes de começar

O básico para rodar em um servidor, VPS ou LXC.

Docker Engine e Compose v2 Para o caminho Docker.
Debian ou Ubuntu com systemd Para o binário da release.
Porta livre, com 8080 como padrão Você pode informar outra porta no instalador.
HTTPS e backup por sua conta Configure proxy, domínio e uma rotina de cópia.

Canal Beta consultando... última atualização: consultando data... Consultando o manifest do canal.

Instalação rápida

curl -fsSLo /tmp/contabase-install.sh https://get-contabase.pages.dev/beta/install.sh && bash /tmp/contabase-install.sh

O instalador pergunta porta, URL e proxy. O menu oferece Docker, binário da release ou código-fonte.

docker-compose.yml

services:
  contabase:
    image: ghcr.io/contabase-app/contabase:v1.0.0-beta.6
    container_name: contabase
    restart: unless-stopped
    env_file:
      - .env.docker
    ports:
      - "127.0.0.1:${PORT:-8080}:8080"
    volumes:
      - ./data:/app/data
      - ./uploads:/app/uploads
      - ./backups:/app/backups

Copie o .env.docker e gere os secrets no guia Docker antes de subir a stack.

Terminal

export CONTABASE_VERSION=v1.0.0-beta.6
git clone --branch "$CONTABASE_VERSION" https://github.com/contabase-app/contabase.git
cd contabase
./scripts/install.sh

No menu do instalador, escolha a opção de código-fonte/systemd. O guia completo fica em instalação.

Versão fixa

A versão será exibida após consultar o canal.

O comando com versão fixa usa a tag exibida acima. Não use main, beta ou latest como versão.

Já instalado? Atualize com sudo contabase-update vX.Y.Z para uma tag fixa ou sudo contabase-update --channel beta para acompanhar o canal. Veja o guia de atualização.

Canal Stable em preparação última atualização: sem data de publicação

Consultando o manifest do canal Stable.

Em preparação

A primeira Stable ainda não foi publicada.

O canal Stable será aberto quando a release cumprir os gates de publicação. Até lá, a Beta pública é o caminho suportado para instalar e testar.

Instalação Stable

A versão Stable será exibida quando o canal for publicado.

Comando com a tag Stable publicada. Confirme a versão e os checksums na release antes de executar.

Ver release Stable

Hardware recomendado

Valores de referência para uma instalação Docker ou LXC/VPS.

Requisitos mínimos e recomendados de hardware
Recurso	Mínimo	Recomendado
CPU	1 vCPU	2 vCPU
RAM	512 MB	1 GB
SSD	10 GB	20 GB
Swap	512 MB	1 GB
Usuários	1 a 3	5 a 15*

* A faixa de 5 a 15 usuários depende do uso simultâneo, do volume de dados e da rotina de backup.

Ler requisitos

Transparência

Saiba exatamente o que você está executando.

A instalação pública é uma cadeia de arquivos verificáveis. Cada etapa tem uma responsabilidade e pode ser lida antes da execução.

01

Bootstrap do canal

O arquivo /beta/install.sh consulta o manifest do canal e baixa o instalador da tag publicada. Ele não executa o conteúdo do manifest.

Abrir o script bruto Ler como texto Código no GitHub
02

Manifest da versão

/channels/beta.json declara a tag Beta atual. A página usa esse manifest para exibir a versão, a data e montar o comando com versão fixa.

Abrir o manifest Código no GitHub
03

Instalador da tag

O instalador oficial da tag baixa o helper e valida a versão e os artefatos da release antes de encaminhar a instalação.

Script da tag Release da versão Checksums
04

Método escolhido

O instalador guiado encaminha para Docker, binário de release ou source. Cada método tem seu próprio guia e seus próprios requisitos.

Docker LXC/VPS Source

Baixar, inspecionar e executar

curl -fsSLo /tmp/contabase-install.sh https://get-contabase.pages.dev/beta/install.sh
less /tmp/contabase-install.sh
bash /tmp/contabase-install.sh

Ler apenas o bootstrap não audita a instalação inteira. Confira também o manifest, o instalador da tag e os checksums dos artefatos antes de executar.

Ajuda e projeto

Documentação, suporte e código-fonte

A documentação cobre instalação, atualização, backup e operação. O código e o histórico ficam no repositório público.

Ajuda & documentação Guia de instalação, configuração inicial e uso do dia a dia.

Código-fonte Repositório público e histórico de commits.

Reportar problema Encontrou um bug ou tem uma sugestão? Abra uma issue.

Versões e releases Tags, artifacts e checksums publicados.

Segurança Como reportar vulnerabilidades.

Licença AGPL-3.0 Livre para usar, estudar, modificar e auto-hospedar.

Dúvidas frequentes

Perguntas rápidas

Respostas curtas para as decisões que aparecem antes e depois do primeiro deploy.

Meus dados ficam salvos onde?

No banco SQLite da sua instalação, dentro do volume ou diretório que você configurar. O ContaBase não envia dados financeiros para servidores de terceiros.

Preciso saber programar para usar?

Não no caminho guiado. O instalador pergunta porta, URL e proxy, e encaminha para Docker ou para o binário da release. A compilação por source exige Go e Node.

Serve para a família e para o negócio ao mesmo tempo?

Sim. O sistema é multiusuário e separa contextos em workspaces Pessoal e Business, com permissões por workspace.

Como faço backup?

O painel administrativo exporta o banco em .db. Para uma cópia completa, preserve também data/uploads e os segredos do ambiente. Agende uma rotina para um destino externo e teste o restore. Veja o guia de backup.

Posso contribuir com o projeto?

Sim. O projeto é aberto sob AGPL-3.0. Contribuições de código, tradução, documentação e relatos de bugs passam pelo repositório oficial.

Qual é a diferença entre o canal Beta e o comando com versão fixa?

O canal Beta consulta /channels/beta.json e instala a tag publicada no momento. O comando com versão fixa usa a tag exibida nesta página e não muda quando o canal avançar.

Assuma o controle das suas finanças

Código aberto, dados no seu servidor
e uma instalação guiada para Docker, VPS ou LXC.

Começar a instalar Abrir a ajuda