Troubleshooting
Common issues and solutions when working with the course examples.
Docker Issues
Port Already in Use
Error: bind: address already in use
Solution: Change the port in docker-compose.yml or stop the conflicting service.
Permission Denied
Error: permission denied while trying to connect to the Docker daemon
Solution: Add your user to the docker group:
sudo usermod -aG docker $USER
newgrp docker
Build Issues
TypeScript: Module Not Found
Solution: Install dependencies:
npm install
Python: Module Not Found
Solution: Install dependencies:
pip install -r requirements.txt
Runtime Issues
Connection Refused
Solution: Check that all services are running:
docker-compose ps
Node Can't Connect to Peers
Solution: Verify network configuration in docker-compose.yml. Ensure all nodes are on the same network.
Getting Help
If you encounter issues not covered here:
- Check the Docker logs:
docker-compose logs - Verify your Docker installation:
docker --version - See Further Reading for additional resources