Skip to main content
Deploy and manage kombify TechStack using Coolify, the self-hostable Heroku/Netlify alternative.

​
Overview

Coolify is an open-source platform for deploying applications with:
  • Docker-based deployments
  • Automatic SSL certificates
  • Git integration
  • Built-in monitoring
You can use Coolify to deploy kombify TechStack alongside your other services.

​
Prerequisites

Coolify instance

Coolify v4.0+ installed

Server access

SSH access to your server

​
Deployment options

1

Create new resource

In Coolify dashboard:
  • Click + New Resource
  • Select Docker Compose
2

Configure source

  • Name: kombify-stack
  • Source: GitHub repository
  • Repository: https://github.com/kombify/techstack
  • Branch: main
3

Set environment variables

Add these environment variables:
KOMBISTACK_PORT=5260
KOMBISTACK_GRPC_PORT=5263
KOMBISTACK_LOG_LEVEL=info
KOMBISTACK_DATA_DIR=/data
4

Configure volumes

Add persistent volumes:
/data → /app/data
5

Deploy

Click Deploy and wait for the build to complete.

​
Option 2: Docker Image

1

Create new resource

  • Click + New Resource
  • Select Docker Image
2

Configure image

  • Image: ghcr.io/kombify/kombistack:latest
  • Port: 5260
3

Add environment variables

Same as Option 1
4

Deploy

Click Deploy

​
Configure SSL

1

Add domain

In your resource settings:
  • Navigate to Domains
  • Add your domain: stack.yourdomain.com
2

Enable SSL

Coolify automatically provisions Let’s Encrypt certificates.Wait for the certificate to be issued (usually 1-2 minutes).
3

Verify

Access your Stack at https://stack.yourdomain.com

​
Deploy kombify Simulate alongside TechStack

1

Create new Docker Compose resource

  • Name: kombify-sim
  • Repository: https://github.com/kombify/simulate
2

Configure ports

Expose these ports:
  • 5270 — Simulate API
  • 5271 — Simulate UI
  • 2222-2322 — SSH for simulated nodes
3

Link to Stack

Add environment variable:
KOMBISIM_STACK_URL=http://kombistack:5260
4

Deploy

Both TechStack and Simulate will be running on the same server.

​
Monitoring

​
View logs

In Coolify dashboard:
  1. Navigate to your resource
  2. Click Logs
  3. View real-time logs

​
Health checks

Add health check endpoint: 
healthcheck:
  test: ["CMD", "curl", "-f", "http://localhost:5260/api/v1/health"]
  interval: 30s
  timeout: 10s
  retries: 3

​
Backup and restore

​
Backup

Coolify automatically backs up volumes. To manually backup: 
# SSH into your server
ssh user@your-server

# Backup kombify data
docker run --rm \
  -v kombistack_data:/data \
  -v $(pwd):/backup \
  alpine tar czf /backup/kombistack-backup.tar.gz /data

​
Restore

# Restore from backup
docker run --rm \
  -v kombistack_data:/data \
  -v $(pwd):/backup \
  alpine tar xzf /backup/kombistack-backup.tar.gz -C /

​
Update kombify TechStack

1

Pull latest changes

In Coolify dashboard:
  • Navigate to your resource
  • Click Redeploy
2

Automatic updates

Enable automatic deployments:
  • Go to Settings → Auto Deploy
  • Enable Deploy on Git Push

​
Troubleshooting

If ports are already in use, change them in Coolify:
  1. Navigate to Ports
  2. Change 5260 to another port (e.g., 5360)
  3. Update environment variables accordingly
Fix permission issues:
# SSH into server
docker exec -it kombistack chown -R 1000:1000 /app/data
Verify DNS is pointing to your server:
dig stack.yourdomain.com
Ensure port 80 and 443 are open.

​
Advanced: Deploy full kombify ecosystem

Deploy all kombify components with Coolify:
docker-compose.yml
services:
  kombistack:
    image: ghcr.io/kombify/kombistack:latest
    ports:
      - "5260:5260"
      - "5263:5263"
    volumes:
      - stack-data:/app/data

  kombisim:
    image: ghcr.io/kombify/kombisim:latest
    ports:
      - "5270:5270"
      - "2222-2322:2222-2322"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - sim-data:/app/data

  traefik:
    image: traefik:v3.0
    ports:
      - "80:80"
      - "443:443"
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - traefik-data:/letsencrypt

volumes:
  stack-data:
  sim-data:
  traefik-data:

​
Next steps

Proxmox integration

Manage Proxmox VMs with kombify

Zitadel integration

Set up SSO with Zitadel

Quick start

Self-host kombify TechStack

Architecture

Understand kombify architecture