Skip to content
Sunroom

Access tokens and the CLI

Greenhouse, Atrium, WorkroomCLI 1.6.06 min read

The sunroom command-line tool is a single binary for Linux, macOS and Windows. It uses the same chunked upload engine as the desktop client, which makes it handy for servers, render farms and nightly jobs.

Create a token

  1. Go to Account, Access tokens and choose New token.
  2. Name it after the machine that will use it, for example render-node-04.
  3. Pick scopes: read, write, share. Limit the token to one folder if you can.
  4. Copy the token now. It is shown once and starts with srt_.

Treat a token like a password. Never commit it to a repository. Revoke it from the same page if a machine is lost.

Install and sign in

$ curl -fsSL https://n69.assetlines.net/cli | sh
$ sunroom --version
sunroom 1.6.0 (build 2026-10-12)
$ export SUNROOM_TOKEN=srt_xxxxxxxxxxxxxxxx
$ sunroom whoami
tove@studio  plan=greenhouse  region=eu-north-1  used=4.1TB/6TB

Upload a big file

$ sunroom put harbor-days-delivery.zip /Deliveries/ --connections 8
harbor-days-delivery.zip  38.1 GB  [##########----------]  52%  412 MB/s  eta 00:41
$ sunroom verify /Deliveries/harbor-days-delivery.zip
sha256 4be1d09c...a77f  OK

If the command is interrupted, run it again. It reads the chunk list from the server and sends only what is missing.

Create a link

$ sunroom share /Deliveries/harbor-days-delivery.zip --expires 30d --password-prompt
https://n69.assetlines.net/s/Hq3vN8ztLw2Rb6Yc/

Limits

  • Up to 600 API requests per minute per token. Uploads of one large file count as one request per 64 MB chunk.
  • A token can be used from any network, but you can restrict it to a list of IP ranges on Atrium and Workroom.
  • Tokens expire after 365 days unless you pick a shorter lifetime.