Troubleshooting

I cannot log in

• Double-check your email and password.
• If using SSO, ensure your identity provider (e.g., GitHub, Google) is not blocked.
• Reset your password via the Forgot Password option.
• Still stuck? Contact hi@aquanode.io.

My dashboard is empty

• Confirm you are logged into the correct account/workspace.
• Check if your team/workspace has active resources.
• Refresh the page or log out and back in.

Machine deployment fails

• Verify your GPU quota (some providers limit access).
• Ensure your Aquanode storage config is valid.
• Check logs in the deployment console for errors.
• Try a smaller machine size or different provider region.

Model deployment doesn’t start

• Confirm your model repository is accessible (e.g., public Hugging Face or GitHub repo).
• If using a private repo, ensure you’ve configured the correct access token.
• Check that your Docker image builds successfully locally.
• Verify the model template supports your selected GPU.

Snapshots not working

• Check the Snapshots card on your deployment's Overview tab: it shows which paths are captured and on what interval.
• The card is read-only. To capture state yourself, use Save & pause or save a version.

Billing or usage looks incorrect

• Verify the correct workspace is selected.
• Refresh the billing dashboard.
• Remember: prices may differ between providers (Voltage Park, Verda, Akash Network, Hyperstack, Vast.ai, Vultr, Massed Compute, Cudo Compute [retired, no longer accepting new deployments], Hot Aisle, RunPod).
• Contact hi@aquanode.io if discrepancies remain.

---

General Tips

• Always check the documentation for the latest setup guides.
• Monitor real-time logs from your machine or deployment for errors.
• When reporting issues, include:
  • Your account email
  • The resource ID or deployment ID
  • Error messages/screenshots