Install and Self-Host Capka
Capka runs on a Linux server with Docker. A small VPS is enough for an initial deployment; no Kubernetes cluster or external managed service is required.
System requirements
- Linux on x86_64 or arm64.
- Docker; the installer can install it when it is missing.
- At least 2 GB RAM and 20 GB of disk; 4 GB RAM is recommended.
- A model API key, an OpenAI-compatible endpoint, or a reachable Ollama instance.
Run the installer
Inspect the installer source on GitHub, then run:
curl -fsSL https://raw.githubusercontent.com/LyoSU/capka/master/install.sh | shThe installer checks Docker, pulls the prebuilt stack, creates secrets and starts Capka. Without a domain it can offer a free HTTPS address at <your-ip>.sslip.io; with a domain, Caddy provisions HTTPS automatically. Installation details can change between releases, so the repository installer is the source of truth.
First run
- Open the URL printed by the installer.
- Create the first administrator account.
- Connect a model provider or a local model endpoint.
- Create a chat, attach a small file and confirm that the result can be downloaded.
Updates and support
Use the instructions attached to the current Capka release. Production pull-only deployments should track the stable branch or pin CAPKA_VERSION; master is the development tip. Back up first because database migrations are forward-only. Report reproducible problems in GitHub Issues.