Skip to content
Start free
Documentation menu

Quickstart

You will need a Quayline organisation, a terminal with Docker or Node installed, and about five minutes. The examples use the organisation slug tidewater; replace it with yours.

Install the CLI

qln is a single binary. It manages tokens, repositories and policies, and wraps the upload protocols that do not have a native client, such as generic objects and the CI cache.

terminal
$ npm install -g @quayline/qln
$ qln --version
qln 2.14.3 (linux-x64, built 2026-10-28)

Sign in and create a token

Interactive login opens your browser and stores a session for the CLI. For machines, create a scoped token instead.

terminal
$ qln login
Open https://fi4.enotcloud.com/login.html and enter code KXQT-4821
waiting for approval... signed in as ines@tidewater.build (org: tidewater)

$ qln token create --name laptop-dev --scope "push:tidewater/*" --expires 30d
qlt_live_8Jx2...redacted
note: this value is shown once. Store it in your secret manager.
Tokens begin with qlt_live_. Anything that starts that way in a commit or a log line is treated as leaked and revoked automatically within a minute; see leaked tokens.

Push the first artifact

Pick a client
$ echo "$QLN_TOKEN" | docker login fi4.enotcloud.com -u tidewater --password-stdin
Login Succeeded

$ docker build -t fi4.enotcloud.com/tidewater/api:1.0.0 .
$ docker push fi4.enotcloud.com/tidewater/api:1.0.0
1.0.0: digest: sha256:0d9e51b7a3c6...f12 size: 1573
$ npm config set @tidewater:registry https://fi4.enotcloud.com/npm/tidewater/
$ qln npm-auth --org tidewater      # writes the matching _authToken line to ~/.npmrc
$ npm publish
+ @tidewater/ui-kit@1.0.0
$ cat >> ~/.pypirc <<'EOF'
[quayline]
repository = https://fi4.enotcloud.com/pypi/tidewater/
username = __token__
password = <your token>
EOF
$ python -m build
$ twine upload -r quayline dist/*
$ qln generic put ./dist/installer-1.0.0.pkg tidewater/installers/1.0.0/
published tidewater/installers/1.0.0/installer-1.0.0.pkg (84.2 MB)
$ curl -LO -H "Authorization: Bearer $QLN_TOKEN" https://fi4.enotcloud.com/generic/tidewater/installers/1.0.0/installer-1.0.0.pkg

Verify

List what is stored and where it lives. Every artifact reports its home region, its replicas and its content digest.

terminal
$ qln ls tidewater/api
TAG      DIGEST          SIZE      HOME          REPLICAS
1.0.0    sha256:0d9e51   172 MB    eu-north-1    -

$ qln usage --month 2026-11
storage   0.17 GB of 120 GB included (3 seats x 40 GB)
egress    0.00 TB of 3 TB included

Where to go next