Get quinectl¶
You download quinectl with your Quine Enterprise or Novelty license, check it against its published
checksum, and put it on your PATH. Either license works, and you need only one. If you don't have a
license, contact thatDot sales at sales@thatdot.com. Each license pulls
only its own product's image, so to run both products you need both licenses. See
License Management.
quinectl comes from the same private registry as the Quine Enterprise and Novelty images,
registry.license.thatdot.com. You sign in with your customer id and license key:
- Username: your thatDot customer id.
- Password: your license key.
Supported platforms¶
Each platform has its own tag. Every tag holds two files: the archive and checksums.txt.
| Platform | Architecture | Tag | Archive |
|---|---|---|---|
| macOS | arm64 (Apple silicon) |
1.0.10-darwin-arm64 |
quinectl_1.0.10_darwin_arm64.tar.gz |
| macOS | amd64 (Intel) |
1.0.10-darwin-amd64 |
quinectl_1.0.10_darwin_amd64.tar.gz |
| Linux | amd64 |
1.0.10-linux-amd64 |
quinectl_1.0.10_linux_amd64.tar.gz |
| Linux | arm64 |
1.0.10-linux-arm64 |
quinectl_1.0.10_linux_arm64.tar.gz |
| Windows | amd64 |
1.0.10-windows-amd64 |
quinectl_1.0.10_windows_amd64.tar.gz |
Each platform also has a latest-<os>-<arch> tag that always points to the newest release; see
Pick a version.
Before you start¶
- oras. quinectl is published as files, not a container image, so
docker pullgives you nothing to run. Download it with the oras CLI. Check withoras version. -
Your customer id and license key. The examples assume they're in these environment variables, which quinectl itself also reads:
export QE_LICENSE_KEY=<your license key> export QE_CUSTOMER_ID=<your thatDot customer id>With a Novelty license, use
NOVELTY_LICENSE_KEYandNOVELTY_CUSTOMER_IDin the commands below instead. -
On Windows, Docker Desktop. quinectl runs on Windows with Docker Desktop, and
quinectl trustisn't available there. See Compatibility.
Pick a version¶
Every release is published under two tags per platform:
latest-<os>-<arch>, which always points to the newest release;<version>-<os>-<arch>, such as1.0.10-linux-amd64, which never changes.
The steps in Download and install pull latest. To install a specific
version, use this command for the download in step 3 instead:
oras pull "registry.license.thatdot.com/thatdot/quinectl:1.0.10-${OS}-${ARCH}"
To list every published tag:
oras repo tags registry.license.thatdot.com/thatdot/quinectl
Download and install¶
Run these in a new, empty directory, all in the same shell: later steps use the OS and ARCH variables
set in step 1.
-
Work out your platform. The output is the end of a tag in Supported platforms.
OS=$(uname -s | tr '[:upper:]' '[:lower:]') ARCH=$(uname -m | sed -e 's/x86_64/amd64/' -e 's/aarch64/arm64/') echo "${OS}-${ARCH}"The Windows build is
windows-amd64. There is nothing to work out. -
Sign in to the registry.
orasstores the credential in the same place asdocker login, so if you have already signed in to pull an image, you can skip this.printf '%s' "$QE_LICENSE_KEY" | oras login registry.license.thatdot.com -u "$QE_CUSTOMER_ID" --password-stdinRun
oras login registry.license.thatdot.comwith your customer id as the username and your license key as the password. -
Download the latest release for your platform. You get two files: the archive and
checksums.txt.oras pull "registry.license.thatdot.com/thatdot/quinectl:latest-${OS}-${ARCH}"oras pull registry.license.thatdot.com/thatdot/quinectl:latest-windows-amd64 -
Check the archive against
checksums.txt.grep "_${OS}_${ARCH}.tar.gz" checksums.txt | sha256sum -c -The output ends with
OK. On a Mac withoutsha256sum, useshasum -a 256 -c -in its place.Run
Get-FileHashon the archive and compare the hash with the archive's line inchecksums.txt. They match, ignoring case.If the check fails, delete both files and download them again.
-
Unpack it and put quinectl on your
PATH.This example uses
~/.local/bin. If that directory isn't on yourPATH, which is usual on macOS, runexport PATH="$HOME/.local/bin:$PATH"and add the same line to your shell profile. Or use any directory that is on yourPATH.tar -xzf quinectl_*_"${OS}_${ARCH}".tar.gz mkdir -p ~/.local/bin install -m 0755 quinectl ~/.local/bin/quinectlUnpack the archive with
tar -xzf. It holdsquinectl.exe; move it to a folder on yourPATH. -
Confirm it runs.
quinectl versionquinectl version 1.0.10 (release, darwin/arm64, commit df25f95517e6, built 2026-11-12T17:20:56Z) verified against Quine 2.2.xThe second line names the Quine release line this quinectl was tested with. See Compatibility.
To upgrade or uninstall quinectl later, see Upgrade quinectl and Uninstall quinectl.
Troubleshooting¶
| What you see | What it means |
|---|---|
response status code 401: Unauthorized from oras login |
The customer id or license key is wrong, or the license has expired. Check both values, then contact thatDot support. |
response status code 401: Unauthorized from oras pull |
You're not signed in to the registry. Run step 2 again. |
...quinectl:latest-<os>-<arch>: not found |
No build exists for that platform. Check echo "${OS}-${ARCH}" against Supported platforms. |
Next steps¶
- Run Quine Enterprise with auth and call its REST API: Quick Start.
- Check which Quine release and images this quinectl release starts: Compatibility.