Skip to content

Troubleshooting

BangerTech edited this page Jan 2, 2025 · 1 revision

Troubleshooting Guide

Common Issues

Container Won't Start

  1. Check Docker status:
sudo systemctl status docker
  1. Verify container logs:
docker logs webdock-ui
  1. Check permissions:
ls -l /home/webDock/docker-compose-data

Connection Issues

  1. Verify port availability:
sudo netstat -tulpn | grep 8585
  1. Check firewall settings:
sudo ufw status

Permission Problems

  1. Reset ownership:
sudo chown -R $USER:$USER /home/webDock
  1. Set correct permissions:
sudo chmod -R 755 /home/webDock

Log Files

  • Container logs: docker logs webdock-ui
  • Application logs: Check browser console
  • System logs: journalctl -u docker

Getting Help

  1. Check the FAQ
  2. Search existing Issues
  3. Create a new issue with:
    • System information
    • Error messages
    • Steps to reproduce
Clone this wiki locally