Kimai

Accessing Kimai

Open in browser: http://<SERVER_IP>

Login credentials:

• Email: [email protected]
• Password: Stored inside /opt/kimai/.env

Retrieve credentials:

cat /opt/kimai/.env

Important Files & Directories

• Install Path: /opt/kimai
• Compose File: /opt/kimai/docker-compose.yml
• Environment File: /opt/kimai/.env
• Caddy Configuration: /opt/kimai/Caddyfile
• Data Volume: /var/lib/docker/volumes/kimai_data
• MySQL Volume: /var/lib/docker/volumes/kimai_mysql
• Plugins Volume: /var/lib/docker/volumes/kimai_plugins
• Caddy Data Volume: /var/lib/docker/volumes/kimai_caddy_data
• Caddy Config Volume: /var/lib/docker/volumes/kimai_caddy_config

Managing the Stack

Change into the installation directory:

cd /opt/kimai

Check container status:

docker compose ps

View logs:

docker compose logs -f

Restart services:

docker compose restart

Stop the stack:

docker compose down

Start the stack:

docker compose up -d

Domain & HTTPS (Caddy)

0. HTTPS does NOT work with IP addresses.

1. Point a domain (e.g. kimai.example.com) to your server’s IP address.

2. Edit the Caddy ( /opt/kimai/Caddyfile) configuration:

kimai.example.com {
    reverse_proxy kimai:8001
}

3. Restart services:

docker compose -f /opt/kimai/docker-compose.yml restart

4. Caddy will automatically request and renew Let's Encrypt SSL certificates.