doknyudocs

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 docker

Veja 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 docker

Se 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 libfuse2

Confira 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 doknyu

Ele é 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

Nesta página