Overview

aq is Aquanode's control CLI. It runs on your laptop and talks to the Aquanode API to rent a GPU, provision the box, and optionally bring up an app on it or restore a snapshot - turning that workflow into one-command deploys.

curl -fsSL https://github.com/Aquanodeio/aq-releases/releases/latest/download/install.sh | sh

What you can do

• aq gpus - browse live GPU prices across every provider, no account or login needed - see the Command Reference
• aq login - pair the CLI to your Aquanode account via device-login
• aq up - rent the cheapest matching GPU; bare by default, or with --comfyui/--jupyter to install an app on it; see live rates across every provider on the Aquanode Marketplace before you deploy
• aq ssh [name] - get a shell on a box: managed keypair, managed ~/.ssh/config alias, zero setup
• aq status <name|id> - check a deployment's status, HTTPS URL, and credentials
• aq save <name|id> - save a pod's current state into its named lineage
• aq pause <name|id> - save a pod, then release its machine (resume with aq deploy --snapshot <id>)
• aq down <name|id> - tear down a deployment and stop billing
• aq import - capture a box you rent elsewhere (RunPod, Vast, your own hardware) into a portable Aquanode pod
• aq host add / aq attach - use a box you already lease directly, detached or joined to the console; see Bring your own box
• aq push [name|id] - send your working directory to a box you already rented
• aq run [name|id] -- <cmd> - push, then run a command on the box (add --detach to keep it running after you disconnect)
• aq logs [name|id] - read a detached run's output (aq logs --list shows every run on a box)
• aq ls - list what's running and what it costs (aq pods lists what you own, running or not)

That's the everyday loop. aq also covers sharing/forking saved versions, per-pod and per-deployment idle policy, and jobs - the full command reference covers every command.

Get started

• Install the CLI - the install command, direct download, and verifying aq version
• Quickstart - pair your account, rent a GPU, and get a shell on it
• aq import - bring an existing box in from another provider
• Bring your own box - use a box you already lease, detached or attached, without migrating off it
• Command Reference - every command, flag, and environment variable