CLI

conveyor-cli is a small companion binary bundled alongside the main server, for tasks that don’t belong in the web UI.

Conveyor CLI

Commands:
  generate-key     Generate a new encryption key
  user:create      Create a new user (interactive)

generate-key

Generates a random 32-byte key and prints it as 64 hex characters. This is the value you set as CONVEYOR_ENCRYPTION_KEY. It doesn’t touch the database or require any configuration to run.

./conveyor-cli generate-key

In Docker:

docker compose exec conveyor /app/conveyor-cli generate-key

Or, before you have a running container at all:

docker run --rm ghcr.io/smitmartijn/conveyor:latest /app/conveyor-cli generate-key

user:create

Creates a new user interactively. It prompts for name, email, and password (password input is hidden). Unlike CONVEYOR_ADMIN_EMAIL/CONVEYOR_ADMIN_PASSWORD, this works at any time, not just on first boot, so it’s the way to add additional users to an existing instance.

This command needs a working configuration (CONVEYOR_ENCRYPTION_KEY and CONVEYOR_DATA_DIR at minimum) since it opens the database directly.

docker compose exec -it conveyor /app/conveyor-cli user:create

From source:

go run ./cmd/cli user:create