Troubleshooting

Fast diagnosis guide for the most common daemon, deployment, TLS, backup, and release issues.

TUI cannot connect to daemon

sudo systemctl status voxeltrond
sudo journalctl -u voxeltrond -n 200 --no-pager
ss -ltnp | grep 7443

Deployment fails during build/import

docker ps -a
sudo journalctl -u voxeltrond -n 300 --no-pager
cargo test -p voxeltrond import::tests::

TLS certificate or domain issues

sudo journalctl -u voxeltrond | grep -i -E 'acme|cert|tls|challenge'

Backup/release integrity verification

./scripts/release/verify-release-artifacts.sh dist

Manual release failures on build-mac

./scripts/release/manual-release.sh vX.Y.Z --dry-run
./scripts/release/manual-release.sh vX.Y.Z