troubleshooting
common issues and how to resolve them
node won't start
# check docker is running docker info # check configuration neuranet config # check logs for errors neuranet logs --tail 50
most startup issues are related to docker not running or configuration problems.
no jobs received
- check internet connection:
ping gateway.neuranet.network - check firewall: ensure docker can access internet
- check rate: lower rates get more jobs
- check status:
neuranet status
gpu not detected
# check nvidia drivers nvidia-smi # check docker gpu access docker run --rm --gpus all nvidia/cuda:12.0-base nvidia-smi # update nvidia container toolkit (linux) sudo apt-get install -y nvidia-container-toolkit sudo systemctl restart docker
gpu detection requires proper nvidia drivers and nvidia container toolkit.
configuration issues
# reset configuration (WARNING: removes API key) neuranet config reset # then re-register neuranet register --wallet YOUR_WALLET --name "My Node"
warning: resetting configuration removes your api key. you'll need to re-register your node.
connection issues
- check gateway connectivity:
curl -I https://gateway.neuranet.network/health - check websocket connection: logs should show "connected to gateway" message
- restart the node:
neuranet restart
docker issues
# check docker daemon status sudo systemctl status docker # restart docker sudo systemctl restart docker # check docker logs sudo journalctl -u docker -n 50 # clean up unused containers and images docker system prune -f
security best practices
do:
- ✓ keep your wallet private key secure (node only needs public address)
- ✓ run behind a firewall
- ✓ keep docker updated
- ✓ monitor logs regularly
- ✓ use strong passwords for your server
don't:
- ✗ share your api key with anyone
- ✗ run as root (use regular user with docker permissions)
- ✗ expose docker socket to network
- ✗ disable security features
getting help
still having issues? reach out through these channels: