Quickstart

Create an account. New accounts start with $5 of prepaid credit, and the Free plan includes $1/month of usage with a hard cap. Top up or pick Hobby/Pro when you need more.

Install the CLI. It's a single Python 3 script and runs on macOS and Linux. On Windows, use it inside WSL.

# system-wide (asks for your password)
sudo curl -fsSL https://api.aloof.si/cli/aloof -o /usr/local/bin/aloof && sudo chmod +x /usr/local/bin/aloof

# or without sudo, into ~/.local/bin (make sure it's on your PATH)
mkdir -p ~/.local/bin && curl -fsSL https://api.aloof.si/cli/aloof -o ~/.local/bin/aloof && chmod +x ~/.local/bin/aloof

Check it with aloof --help. It needs python3, which macOS and most Linux distributions already have.

Log in. New here? aloof signup you@company.com creates an account and saves the key for you. Already have an account? Copy your API key from Dashboard → API keys and save it in ~/.aloof.json:
```
{"api": "https://api.aloof.si", "key": "pk_..."}
```
Then chmod 600 ~/.aloof.json, since the key has full access to your account. In CI, set ALOOF_API_URL and ALOOF_API_TOKEN (a deploy token) instead.

Deploy:

aloof deploy hello --image nginx:alpine --port 80
live: https://hello.aloof.si/

Your app must listen on $PORT (default 8080) over HTTP. Configure it with env vars, and keep persistent data on a volume. If something goes wrong, see Troubleshooting.