Skip to content

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 pull gives you nothing to run. Download it with the oras CLI. Check with oras 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_KEY and NOVELTY_CUSTOMER_ID in the commands below instead.

  • On Windows, Docker Desktop. quinectl runs on Windows with Docker Desktop, and quinectl trust isn'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 as 1.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.

  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.

  2. Sign in to the registry. oras stores the credential in the same place as docker 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-stdin
    

    Run oras login registry.license.thatdot.com with your customer id as the username and your license key as the password.

  3. 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
    
  4. Check the archive against checksums.txt.

    grep "_${OS}_${ARCH}.tar.gz" checksums.txt | sha256sum -c -
    

    The output ends with OK. On a Mac without sha256sum, use shasum -a 256 -c - in its place.

    Run Get-FileHash on the archive and compare the hash with the archive's line in checksums.txt. They match, ignoring case.

    If the check fails, delete both files and download them again.

  5. Unpack it and put quinectl on your PATH.

    This example uses ~/.local/bin. If that directory isn't on your PATH, which is usual on macOS, run export PATH="$HOME/.local/bin:$PATH" and add the same line to your shell profile. Or use any directory that is on your PATH.

    tar -xzf quinectl_*_"${OS}_${ARCH}".tar.gz
    mkdir -p ~/.local/bin
    install -m 0755 quinectl ~/.local/bin/quinectl
    

    Unpack the archive with tar -xzf. It holds quinectl.exe; move it to a folder on your PATH.

  6. Confirm it runs.

    quinectl version
    
    quinectl version 1.0.10 (release, darwin/arm64, commit df25f95517e6, built 2026-11-12T17:20:56Z)
    verified against Quine 2.2.x
    

    The 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.