Peter Steinberger 2d3a2cf0e7

2026-05-08 08:53:47 +01:00

2.3 KiB

Raw Permalink Blame History

title	description
Install	Ways to get a ClickClack binary running — from-source, Docker, or build-and-copy.

Install

ClickClack ships as a single Go binary that embeds the Svelte SPA and the SQL migrations. There are three sensible ways to install it.

From source

You'll need a recent Go and pnpm 11 (auto-managed via corepack).

git clone https://github.com/openclaw/clickclack.git
cd clickclack
pnpm install
pnpm build
go run ./apps/api/cmd/clickclack serve
# open http://localhost:8080

pnpm build builds the SPA + the TypeScript SDK and copies apps/web/dist into apps/api/internal/webassets/dist so go:embed can bake it into the binary. The Go build will fail without that step.

To produce a standalone binary instead of go run:

pnpm build
go build -o clickclack ./apps/api/cmd/clickclack
./clickclack serve --addr :8080 --data /var/lib/clickclack

Docker

The repo ships a multi-stage Dockerfile:

docker build -t clickclack .
docker run --rm -p 8080:8080 -v clickclack-data:/app/data clickclack

The image runs as a non-root clickclack user, exposes 8080, and mounts /app/data as a volume. Override the entrypoint command to run admin tasks:

docker run --rm -v clickclack-data:/app/data clickclack \
  admin bootstrap --name "Peter" --email steipete@gmail.com

Pre-built binaries

GitHub releases publish clickclack archives for Linux, macOS, Windows, and FreeBSD on amd64 and arm64, plus Linux .deb and .rpm packages.

# macOS/Linux tarball shape
tar -xzf clickclack_<version>_<os>_<arch>.tar.gz
./clickclack version

# Linux packages
sudo dpkg -i clickclack_<version>_amd64.deb
sudo rpm -i clickclack-<version>-1.x86_64.rpm

Release archives include LICENSE, README.md, SPEC.md, CHANGELOG.md, and the docs tree. Checksums are published as sha256sums.txt.

What you get

Either path produces the same clickclack binary with the SPA, migrations, and assets baked in. Data lives in whatever directory you pass to --data (default ./data).

<data>/
  clickclack.db
  uploads/
  logs/

Quickstart — the first 5 minutes.
Configuration — flags, env vars, config file.
Deployment — reverse proxy, OAuth, backups.

2.3 KiB Raw Permalink Blame History