Solução de problemas
Erros comuns e como resolvê-los.
"Permissão negada" no socket do Docker
Seu usuário não está no grupo docker, ou ainda não saiu e entrou de novo na sessão depois de entrar
nele.
sudo usermod -aG docker $USER
# saia da sessão e entre de novo; para conferir:
groups | grep dockerVeja Acesso ao Docker.
"Não foi possível conectar ao Docker"
O daemon provavelmente está parado:
sudo systemctl start docker
# para iniciar junto com o sistema:
sudo systemctl enable dockerSe você usa o Docker rootless, confira se o socket existe em $XDG_RUNTIME_DIR/docker.sock e se o
serviço do usuário está rodando (systemctl --user start docker).
Uso DOCKER_HOST=tcp://... e o app não conecta
O doknyu só suporta sockets locais (unix://). Endereços tcp:// e ssh:// são ignorados.
O AppImage não abre
Falta o FUSE 2. No Ubuntu 22.04/24.04:
sudo apt install libfuse2Confira também se o arquivo tem permissão de execução (chmod +x doknyu-x86_64.AppImage).
A janela não abre ou fica preta
O doknyu desenha a interface pela GPU (Vulkan ou OpenGL) usando o driver do sistema. Se o driver tiver problemas, force o renderizador por software:
ICED_BACKEND=tiny-skia doknyuEle é mais lento, mas funciona em qualquer máquina. Se isso resolver, vale reportar a sua GPU e o seu driver numa issue.
O botão de terminal externo não faz nada
O app não encontrou um emulador de terminal. Defina qual usar:
export TERMINAL=kitty # ou konsole, gnome-terminal, alacritty...Ainda com problema?
Rode com logs detalhados e abra uma issue com a saída:
RUST_LOG=debug doknyu