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 an Environment and Volume - 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 pods create <name> --env <name|id> - start a new pod from a kept or shared Environment, with or without an existing Volume attached
• 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 stop <name|id> - capture the environment and volume, then release the machine
• aq start <name|id> - restore a stopped pod's environment and volume onto a fresh machine
• 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 new Aquanode volume
• 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 and keeping Environment versions, managing Volumes, 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