Skip to content

Self-host in 5 minutes

Prerequisites

Section titled “Prerequisites”
  • Docker + Docker Compose installed
  • Git installed
  • 1 GB RAM minimum (2 GB recommended for production)

Quick start (local / dev)

Section titled “Quick start (local / dev)”

  1. Clone the repo

    Terminal window
    git clone https://github.com/izhubs/izhubs-erp.git
    cd izhubs-erp

  2. Set up environment

    Terminal window
    cp .env.example .env.local
    # Edit .env.local with your values (see table below)

  3. Start services

    Terminal window
    docker compose up -d

  4. Open the app

    Visit http://localhost:1303 — you should see the izhubs login screen.

Environment variables

Section titled “Environment variables”
VariableRequiredDescription
DATABASE_URL✅PostgreSQL connection string
REDIS_URL✅Redis connection string
JWT_SECRET✅Secret for signing JWT tokens (min 32 chars)
JWT_REFRESH_SECRET✅Secret for refresh tokens
NEXT_PUBLIC_APP_URL✅Public URL of your izhubs instance
NODE_ENV—development or production
Section titled “Production deploy (Coolify recommended)”

  1. Push your fork to GitHub

  2. Create a new service in Coolify

    • Source: your GitHub repo
    • Build command: npm install && npm run build
    • Start command: npm start

  3. Add environment variables in Coolify dashboard (same as above)

  4. Configure domain — point your domain to Coolify reverse proxy

  5. Run migrations

    Terminal window
    npm run db:migrate

Keeping up to date

Section titled “Keeping up to date”
Terminal window
git pull origin main
docker compose up -d --build
npm run db:migrate