Access tokens and the CLI
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
- Go to Account, Access tokens and choose New token.
- Name it after the machine that will use it, for example render-node-04.
- Pick scopes: read, write, share. Limit the token to one folder if you can.
- 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.