🧩 Visão Geral

Este guia documenta:

• Acesso root no ZimaOS
• Diferença entre su e sudo
• Correção de permissões do Docker
• Como acessar containers (ex: OpenClaw)
• Boas práticas para ambiente de automação (n8n, IA local, etc.)

🖥️ 1. Acesso Root no ZimaOS

❗ Importante

O ZimaOS não utiliza root tradicional com senha separada.

✔️ Como funciona:

• O usuário criado no setup (ex: HobbyTestLAB)
• Já possui privilégios administrativos via sudo

🚫 Por que su não funciona?

Erro:

su: command not found

Motivo:

• O sistema não inclui su por padrão
• É uma decisão de segurança e simplificação

✅ Como acessar root corretamente

sudo -i

ou:

sudo su

🧪 Testar se você tem root

sudo whoami

Resultado esperado:

root

⚠️ Erro comum

❌ Errado:

sudo i

✅ Correto:

sudo -i

🐳 2. Problema com Docker (Permission Denied)

❌ Erro comum:

permission denied while trying to connect to the Docker daemon socket

🧠 Causa

Seu usuário não está no grupo docker

✅ Solução

Adicionar usuário ao grupo docker:

sudo usermod -aG docker HobbyTestLAB

🔄 Aplicar mudança

newgrp docker

ou:

reboot

🧪 Testar

docker ps

⚡ Alternativa imediata

sudo docker ps

🐳 3. Gerenciamento de Containers

📋 Listar containers ativos

docker ps

🔍 Filtrar container específico

docker ps | grep -i openclaw

🔑 4. Acessar Terminal de um Container

Método padrão

docker exec -it NOME_DO_CONTAINER bash

Exemplo:

docker exec -it openclaw bash

⚠️ Se bash não existir

docker exec -it openclaw sh

👑 Acessar como root dentro do container

docker exec -it --user root openclaw bash

ou:

docker exec -it --user root openclaw sh

🧠 5. Containers com múltiplos serviços

Alguns projetos (como OpenClaw) podem ter vários containers:

Exemplo:

openclaw-api
openclaw-worker
openclaw-db

🎯 Qual acessar?

• api → backend principal
• worker → tarefas em background
• db → banco de dados

⚡ 6. Acesso rápido (atalho avançado)

Entrar automaticamente no container OpenClaw:

docker exec -it $(docker ps | grep -i claw | awk '{print $1}') sh

📜 7. Ver logs do container

docker logs openclaw

🔄 Logs em tempo real

docker logs -f openclaw

🧪 8. Diagnóstico dentro do container

Ver shells disponíveis:

ls /bin

🚀 9. Boas práticas para seu ambiente

Para rodar com estabilidade (n8n, IA, automações):

✔️ Recomendado:

• Usuário com sudo ativo
• Usuário no grupo docker
• Uso de sudo -i para tarefas administrativas
• Containers isolados por função

🔧 Estrutura ideal

• 1 container → n8n
• 1 container → IA (OpenClaw, etc.)
• 1 container → banco (Postgres, Redis)
• Reverse proxy (opcional)

🧠 10. Dicas avançadas

Criar alias para entrar em container

nano ~/.bashrc

Adicionar:

alias denter='docker exec -it $(docker ps | grep -i claw | awk "{print \$1}") sh'

Aplicar:

source ~/.bashrc

Uso:

denter

📌 Resumo Final

🏁 Conclusão

Você já está com o ambiente praticamente pronto para:

• Automações avançadas
• IA local
• Orquestração com Docker
• Projetos como n8n, OpenClaw e similares