Aquanode LogoAquanode Docs

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.

VM 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 VM 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 & backups not working

  • Make sure you're in the Backups section of your deployment.
  • If automated snapshots fail, try a manual snapshot first.

Billing or usage looks incorrect

  • Verify the correct workspace is selected.
  • Refresh the billing dashboard.
  • Remember: prices may differ between providers (Voltage Park, DataCrunch, Akash Network, Hyperstack, Vast.ai, Vultr, Massed Compute, Cudo Compute, Hot Aisle).
  • Contact hi@aquanode.io if discrepancies remain.

General Tips

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