Troubleshooting

Common issues and solutions when getting started with SiteDash.

Installation Issues

macOS: "App is damaged and can't be opened"

This occurs when macOS Gatekeeper blocks unsigned applications. To fix:

xattr -cr /Applications/SiteDash.app

Then try launching the application again.

Linux: Permission Denied

Ensure the binary has execute permissions:

chmod +x ./sitedash
./sitedash --version

Windows: SmartScreen Warning

Windows SmartScreen may block the installer since it is not yet code-signed. Click More info and then Run anyway to proceed.

Connection Issues

Cannot Reach API Server

Verify your internet connection and check if the API server is accessible:

curl -I https://preview.sitedash.ddev.site/api/v1/release/current

If you are behind a corporate firewall or proxy, configure your proxy settings in ~/.sitedash/config.yml.

Authentication Failures

If you receive 401 errors, verify your API token is valid and active. You can test it with:

curl -H "X-SiteDash-Token: YOUR_TOKEN" https://preview.sitedash.ddev.site/api/v1/release/current

Getting Help

If your issue is not listed here, submit a bug report with details about your environment, the steps you took, and any error messages you see.