Auto-hospedagem

Implante o OpenToggl na sua própria infraestrutura com Docker Compose, CasaOS, Synology, fnOS e mais.

Docker Compose

A forma mais rápida de auto-hospedar o OpenToggl.

Início Rápido

mkdir -p opentoggl && cd opentoggl

wget -O docker-compose.yml \
  https://raw.githubusercontent.com/CorrectRoadH/opentoggl/main/docker-compose.yml

docker compose up -d

Aguarde todos os serviços ficarem saudáveis e verifique:

curl -fsS http://localhost:8080/healthz
curl -fsS http://localhost:8080/readyz

Pronto. Abra http://localhost:8080 no seu navegador.

Arquitetura

O arquivo compose inicia três serviços em uma rede interna isolada:

Serviço	Função	Exposto ao host
`opentoggl`	Web + API	Sim (`8080`)
`postgres`	Banco de dados	Não
`redis`	Cache / Fila	Não

Postgres e Redis não são expostos à rede do host. Apenas o serviço opentoggl publica uma porta.

Configuração

Todos os padrões funcionam imediatamente. Substitua via variáveis de ambiente ou um arquivo .env no mesmo diretório do docker-compose.yml:

Variável	Padrão	Descrição
`OPENTOGGL_PORT`	`8080`	Porta do host para a interface web e API
`OPENTOGGL_IMAGE`	`ghcr.io/correctroadh/opentoggl:latest`	Imagem do container (fixe em uma tag de versão para estabilidade)
`OPENTOGGL_POSTGRES_DB`	`opentoggl`	Nome do banco de dados
`OPENTOGGL_POSTGRES_USER`	`postgres`	Usuário do banco de dados
`OPENTOGGL_POSTGRES_PASSWORD`	`postgres`	Senha do banco de dados
`OPENTOGGL_DATABASE_URL`	auto	String de conexão completa (substitui variáveis PG individuais)
`OPENTOGGL_REDIS_URL`	`redis://redis:6379/0`	String de conexão do Redis

Atualização

docker compose pull
docker compose up -d

As migrações de schema são executadas automaticamente na inicialização.

Backup e Restauração

Os dados do banco são armazenados no volume nomeado opentoggl-postgres-data.

# Backup
docker compose exec postgres pg_dump -U postgres opentoggl > backup.sql

# Restauração
docker compose exec -T postgres psql -U postgres opentoggl < backup.sql

Desinstalar

docker compose down      # Para os serviços, mantém os dados
docker compose down -v   # Para os serviços e exclui todos os dados

CasaOS

O CasaOS suporta a instalação de apps a partir de um arquivo Docker Compose.

Abra o painel do CasaOS
Vá em App Store > Instalação Personalizada > Importar docker-compose
Cole o conteúdo do docker-compose.yml
Ajuste a porta da Interface Web para 8080 e salve
Inicie o app pelo seu painel

Após a instalação, acesse o OpenToggl em http://<seu-ip-casaos>:8080.

Synology (群晖)

O Synology DSM 7.2+ suporta Docker Compose através do Container Manager.

Abra Container Manager > Projeto > Criar
Defina um nome de projeto (ex: opentoggl)
Escolha Usar docker-compose.yml e cole o conteúdo do docker-compose.yml
Clique em Próximo e finalize o assistente

Acesse o OpenToggl em http://<seu-ip-synology>:8080.

Se a porta 8080 conflitar com o DSM, adicione OPENTOGGL_PORT=9090 (ou qualquer porta livre) nas configurações de ambiente antes de criar o projeto.

fnOS (飞牛)

O fnOS suporta implantação de apps Docker.

Abra o gerenciamento Docker no fnOS
Crie um novo projeto Compose
Cole o conteúdo do docker-compose.yml
Implante e inicie o projeto

Acesse o OpenToggl em http://<seu-ip-fnos>:8080.

Outras Plataformas NAS / Homelab

O OpenToggl funciona em qualquer plataforma que suporte Docker Compose, incluindo:

Unraid — via Community Applications ou plugin Compose Manager
TrueNAS SCALE — via app personalizado com Docker Compose
Proxmox LXC — instale o Docker dentro de um container LXC, depois siga o guia do Docker Compose

Os passos são os mesmos: obtenha o docker-compose.yml, execute docker compose up -d, acesse a porta 8080.

Verifique Sua Instância

Independentemente da plataforma, execute estas verificações para confirmar uma implantação saudável:

curl -fsS http://<seu-ip>:8080/healthz
curl -fsS http://<seu-ip>:8080/readyz

Ambos devem ter sucesso. Se sim, está tudo pronto.

On this page