Troubleshooting

Problem: "A positional parameter cannot be found that accepts argument" (Windows)

Your folder path has spaces and needs quotes!

Error looks like: Set-Location : A positional parameter cannot be found that accepts argument 'Projects\XEQ'.

Fix: Use quotes around the path:

Wrong (no quotes):

cd C:\Users\YourUsername\Desktop\My Projects\XEQ Testnet

Right (with quotes):

cd "C:\Users\YourUsername\Desktop\My Projects\XEQ Testnet"

Remember: If your folder name has spaces, always use quotes!

---

Problem: "docker: The term 'docker' is not recognized"

Docker is not installed or not running.

Fix:

1. Windows: Make sure Docker Desktop is running (whale icon in system tray)

2. Linux: Make sure Docker is installed (see Install Docker section)

3. Try the docker --version command to verify

---

Problem: "Cannot connect to the Docker daemon" (Linux)

Docker service is not running.

Fix: sudo systemctl start docker sudo systemctl enable docker

---

Problem: "Permission denied" (Linux)

Your user is not in the docker group.

Fix: sudo usermod -aG docker $USER

Log out and log back in

Problem: "Port is already in use"

Something else is using the same port.

Fix:

1. Stop any other nodes: docker stop regular1 docker rm regular1 2. Try starting again

Problem: Node starts but then stops immediately

Check the logs: docker logs regular1

Common causes:

• Docker Desktop not running (Windows)

• Port conflict

• Wrong folder path

Service node won't start:

• Make sure you replaced YOUR_PUBLIC_IP with your actual public IP address

• Check that Docker is running

• Make sure you're in your testnet folder when running commands

Wallet won't connect:

• Make sure the service node (sn01) is running first

• Check logs: docker logs sn01

• Make sure the wallet RPC is running: docker ps | findstr wallet-rpc (Windows) or docker ps | grep wallet-rpc (Linux)

Can't get registration command:

• Make sure your funds are unlocked (check with balance in wallet)

• Make sure you replaced <MY_ADDRESS> with your actual wallet address

• Make sure the service node is fully synced

Registration command fails:

• Make sure you copied the entire command (it's very long)

• Make sure your funds are unlocked

• Check service node logs: docker logs sn01

Still having issues?

• Check the service node logs: docker logs sn01

• Check the wallet RPC logs: docker logs wallet-rpc

• Reach out in the testnet Telegram channel for help