Skip to main content

​
What is drim?

drim is a CLI tool for deploying your Kaneo instances. It’s designed for fairly straightforward setups where you want to get Kaneo up and running quickly without manual configuration. drim handles:
  • Docker Compose file generation
  • Environment variable setup
  • Automatic HTTPS with Caddy
  • Service management (start, stop, restart)
  • Updates and upgrades

​
Installation

Install drim with a single command:
Or download the binary manually from releases.

​
Quick Start

​
Local Development

For local development without a domain:

​
Production Deployment

For production with automatic HTTPS:
Make sure your domain’s DNS A record points to your server before running setup.

​
Commands

drim provides several commands to manage your Kaneo instance:

​
What Gets Installed

When you run drim setup, the following services are deployed:
  • PostgreSQL 16 - Database
  • Kaneo - Combined API and web frontend in a single container
  • Caddy - Reverse proxy with automatic HTTPS
All services run in Docker containers with proper networking and health checks.

​
Configuration

To edit environment variables after setup:
This opens .env in your default editor. After saving, services are restarted automatically. See the environment variables documentation for available options.

​
Requirements

  • Docker 20.10+
  • Docker Compose V2
  • 2GB RAM minimum
  • 10GB disk space
Supported Platforms: Linux, macOS, Windows (WSL)
drim will attempt to install Docker automatically on supported Linux distributions.

​
When to Use drim

drim is ideal for:
  • Quick local development setups
  • Simple production deployments with a single domain
  • Teams that want automatic HTTPS without manual configuration
  • Anyone who wants to get Kaneo running with minimal effort
For more complex setups (multiple domains, custom networking, Kubernetes, etc.), see the manual Docker Compose installation.