Skip to main content

Installation

Qaynaq runs as a single binary with no external dependencies. Choose the method that works best for you.

Install Script​

Download and install the latest release automatically:

curl -Lsf https://qaynaq.io/sh/install | bash

To install a specific version:

curl -Lsf https://qaynaq.io/sh/install | bash -s -- 0.1.0

Docker​

Pull the latest official image:

docker pull ghcr.io/qaynaq/qaynaq

Run the coordinator and worker:

# Start coordinator
docker run -d --name qaynaq-coordinator \
  -p 8080:8080 -p 50000:50000 \
  -e DATABASE_DRIVER=sqlite \
  -e DATABASE_URI="file:/data/qaynaq.sqlite?_foreign_keys=1&mode=rwc" \
  -e SECRET_KEY="this_is_a_32_byte_key_for_AES!!!" \
  -v qaynaq-data:/data \
  ghcr.io/qaynaq/qaynaq -role coordinator -grpc-port 50000

# Start worker
docker run -d --name qaynaq-worker \
  -e DATABASE_DRIVER=sqlite \
  -e DATABASE_URI="file:/data/qaynaq.sqlite?_foreign_keys=1&mode=rwc" \
  -e SECRET_KEY="this_is_a_32_byte_key_for_AES!!!" \
  -v qaynaq-data:/data \
  ghcr.io/qaynaq/qaynaq -role worker -grpc-port 50001 \
  -coordinator-address qaynaq-coordinator:50000

The coordinator will be available at http://localhost:8080.

See Configuration for all environment variables including PostgreSQL and authentication.

Verify Installation​

qaynaq --help

Next Steps​