Back to Home

Troubleshooting

Solutions to common issues

Common Issues
Solutions to frequently encountered problems during installation

Docker permission error

After adding user to docker group, restart the system or open a new terminal session.

Rust installation error

Check your internet connection and retry the command. Check proxy settings if necessary.

Insufficient funds error

Ensure you have enough ETH and USDC on Base Mainnet. Reserve extra ETH for gas fees.

RPC connection error

Verify that the RPC URL in .env.base file is correct and working.

Package download issues (apt update/upgrade fails)

Check your internet connection and DNS settings. Try changing your apt mirrors to a different region. Ensure no firewall is blocking access to package repositories.

Docker daemon not running

Run `sudo systemctl start docker` to start the Docker daemon. If it fails, check `sudo systemctl status docker` for error messages.

Git clone fails (connection timed out)

Verify your internet connection. If you are behind a firewall or proxy, configure git to use the proxy: `git config --global http.proxy http://proxy.example.com:8080`.

Low disk space

Use `df -h` to check disk usage. If low, free up space by deleting unnecessary files or expanding your disk. `ncdu` can help identify large files.

Built with v0