Docker Compose

Di akhir halaman ini Kanesh sudah jalan dengan Docker Compose, dengan semua pengaturan di satu file .env.

Sebelum mulai

• Docker dengan plugin Compose (docker compose version)
• Image Kanesh. Selama preview, build dari source lalu isi KANESH_IMAGE=kanesh.

1. Unduh dua file

• docker-compose.yml
• env.example, simpan sebagai .env

mkdir kanesh && cd kanesh
curl -fsSLO https://YOUR_KANESH_SITE/compose/docker-compose.yml
curl -fsSL https://YOUR_KANESH_SITE/compose/env.example -o .env
chmod 600 .env

2. Pilih database

Database	Di .env	Perintah start
SQLite	DATABASE_DRIVER=sqlite	docker compose up -d
PostgreSQL	DATABASE_DRIVER=postgres, DB_PASSWORD, DATABASE_URL	docker compose --profile postgres up -d
MySQL	DATABASE_DRIVER=mysql, DB_PASSWORD, DATABASE_URL	docker compose --profile mysql up -d

Service database hanya jalan dengan profile-nya, jadi instalasi SQLite cukup satu container.

Note: MySQL memakai DSN go-sql-driver seperti kanesh:secret@tcp(mysql:3306)/kanesh, bukan URL mysql://.

3. Periksa pengaturan penting

Pengaturan	Kenapa penting
COOKIE_SECURE=true	Wajib di balik HTTPS
MCP_ENABLED=true	Menyalakan endpoint MCP untuk Codex dan Claude Code
SETTINGS_ENCRYPTION_KEY	Dibutuhkan untuk menyimpan secret seperti password SMTP dari Studio; simpan cadangannya
TRUSTED_PROXIES	Isi kalau di balik reverse proxy, kalau tidak semua klien berbagi satu batas rate limit
DEMO_MODE	Biarkan false. Kalau true, kredensial owner tampil di layar login

Lihat Konfigurasi untuk semua variabel.

4. Jalankan dan klaim

docker compose up -d
docker compose cp kanesh:/data/claim-token ./claim-token

Buka http://127.0.0.1:8080, tempel token, lalu buat owner.

Penyimpanan file

Upload disimpan di database secara default. Untuk menyimpannya di S3 atau MinIO, atur STORAGE_DRIVER=s3 dan variabel S3_*. Lihat Upload file dan penyimpanan.

Langkah berikutnya

• Setup database
• MCP untuk agent
• Kontrol akses