Como instalar o Arcane (UI de gerenciamento Docker) no Ubuntu 24.04

O Arcane é uma interface moderna para gerenciar containers, imagens, volumes e redes Docker, com foco em simplicidade e rapidez.
É uma alternativa leve ao Portainer e ao Dockge, mantendo compatibilidade com o ecossistema Docker/OCI.

Objetivos

Instalar o Docker no Ubuntu 24.04, subir o Arcane via Docker Compose, acessar o painel, e aprender a atualizar/backup/restaurar e resolver erros comuns.

Pré-requisitos

Antes de começar, você vai precisar de:

• Uma instância Ubuntu 24.04 LTS rodando em nuvem.
  👉 Você pode criar em minutos na LetsCloud em regiões como São Paulo, Fortaleza ou Miami, garantindo baixa latência para seus usuários.
• Usuário com privilégios de sudo.
• Docker Engine e Docker Compose plugin instalados.

Instalando o Docker no Ubuntu 24.04

Antes de instalar, remova versões antigas que possam causar conflito:

$
sudo apt remove docker docker-engine docker.io containerd runc

Etapa 1 - Dependências e chave

$$$$$
sudo apt update
sudo apt install -y ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg  | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
echo "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg]  https://download.docker.com/linux/ubuntu $(. /etc/os-release && echo "$VERSION_CODENAME") stable"  | sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

Etapa 2 - Instalar engine + compose plugin

$$
sudo apt update
sudo apt install -y docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

Etapa 3 - Usar docker sem sudo (opcional)

$$$
sudo usermod -aG docker $USER
newgrp docker
docker version

Subindo o Arcane com Docker Compose

Crie uma pasta para o projeto:

$
mkdir -p ~/arcane && cd ~/arcane

Gere segredos:

$$
openssl rand -base64 32   # ENCRYPTION_KEY
openssl rand -base64 32   # JWT_SECRET

Crie o arquivo compose.yml

$
nano compose.yml

Lembrete: Alterar ENCRYPTION_KEY e JWT_SECRET

services:
  arcane:
    image: ghcr.io/ofkm/arcane:latest
    container_name: arcane
    ports:
      - "3552:3552"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - arcane-data:/app/data
      - ./projects:/app/data/projects
    environment:
      - APP_URL=http://localhost:3552
      - PUID=1000
      - PGID=1000
      - ENCRYPTION_KEY=**COLE_AQUI**
      - JWT_SECRET=**COLE_AQUI**
    restart: unless-stopped

volumes:
  arcane-data:

Suba o serviço:

$
docker compose up -d

Acesse: http://SEU_IP:3552

Primeiros passos no painel

• Username: arcane Password: arcane-admin
• Gerencie containers, imagens, volumes e redes de forma visual.
• Use Projects para organizar seus compose.yml.
• Monitore logs e métricas em tempo real.

Atualizando o Arcane

$$
docker compose pull
docker compose up -d

Backup e restauração

Backup:

$
docker run --rm   -v arcane-data:/data   -v "$PWD":/backup   busybox sh -c 'cd /data && tar czf /backup/arcane-backup.tgz .'

Restore:

$
docker run --rm   -v arcane-data:/data   -v "$PWD":/backup   busybox sh -c 'cd /data && tar xzf /backup/arcane-backup.tgz'

Proxy reverso com Nginx (HTTPS)

server {
  listen 80;
  server_name arcane.seu-dominio.com;
  location / {
    proxy_pass http://127.0.0.1:3552;
    proxy_set_header Host $host;
    proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
    proxy_set_header X-Forwarded-Proto $scheme;
    proxy_http_version 1.1;
    proxy_set_header Upgrade $http_upgrade;
    proxy_set_header Connection "upgrade";
  }
}

Depois, aplique TLS com Let’s Encrypt.

Troubleshooting (erros comuns)

1. permission denied no Docker

   • Confirme o bind do docker.sock.
   • Verifique se o usuário está no grupo docker.

2. Porta ocupada (3552)

   • Altere o mapeamento 3552:3552 no compose.yml.

3. Não abre pela internet

   • Libere a porta no firewall da instância LetsCloud.
   • Confirme configurações de proxy.

Arcane x Portainer x Dockge

• Arcane → UI moderna, rápida, ideal para containers e projetos simples.
• Portainer → mais completo, foco em ambientes enterprise.
• Dockge → otimizado para stacks Docker Compose.

Conclusão

Ao longo deste guia, vimos como instalar e configurar o Arcane em uma instância Ubuntu 24.04 — desde a instalação do Docker até o deploy do Arcane com Docker Compose, passando por backup, atualização, troubleshooting e até a configuração com proxy reverso para HTTPS.

O Arcane se destaca por ser uma UI moderna, leve e prática para gerenciar containers. Ele simplifica tarefas do dia a dia, como rodar imagens, monitorar containers e organizar projetos, sem exigir toda a complexidade de ferramentas mais pesadas como o Portainer.

👉 Para começar, recomendamos:

• Criar uma instância LetsCloud próxima dos seus usuários (São Paulo, Fortaleza ou Miami).
• Subir seu primeiro container (ex.: Nginx ou Redis) via Arcane.
• Testar a gestão de projetos com a pasta ./projects.
• Configurar um proxy reverso com HTTPS para uso em produção.

Assim, você terá um ambiente pronto para desenvolvimento rápido, laboratórios de teste ou até workloads de produção mais leves, sempre com a simplicidade que o Arcane oferece.

Próximos passos: explore a documentação oficial do Arcane e veja como integrar ambientes remotos ou automatizar a atualização de imagens.