> For the complete documentation index, see [llms.txt](https://xeqmlabs.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://xeqmlabs.gitbook.io/docs/documentation/guides/mainnet/testnet/troubleshooting.md).

# 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