Server Installation

Pankha is designed to be deployed using Docker Compose. This guides you through setting up the central server (Backend + Frontend + Database).

Prerequisites

• Docker Engine
• Docker Compose
• 256MB RAM minimum
• 1GB disk space for database

1. Quick Start (Recommended)

Run this one-liner to download the latest production configuration:

mkdir pankha && cd pankha
wget https://github.com/Anexgohan/pankha/releases/latest/download/compose.yml
wget https://github.com/Anexgohan/pankha/releases/latest/download/example.env -O .env

# Start the system
docker compose pull && docker compose up -d

The dashboard will be available at http://localhost:3143.

Deployment Architecture

---
title: Deployment Architecture Flow
---
graph TD
    User([User]) -->|Run Command| Docker[Docker Compose]
    
    subgraph "Pankha Host Machine"
        direction TB
        Docker -->|Starts| Server["Pankha Server (:3143)"]
        Docker -->|Starts| DB[(PostgreSQL :5432)]
        
        Server <-->|Persists Data| DB
        Server -->|Exposes UI| Web[Web Dashboard]
    end

    Web -.->|Access via Browser| User

2. Docker Compose Configuration

If you prefer to configure it manually, here is the standard compose.yml structure:

services:
  app:
    image: anexgohan/pankha:latest
    restart: unless-stopped
    restart: unless-stopped
    ports:
      - "${PANKHA_PORT:-3143}:3143"
    environment:
      - DATABASE_URL=postgresql://pankha:secure_password@postgres:5432/db_pankha
      - NODE_ENV=production
    depends_on:
      - postgres

  postgres:
    image: postgres:15-alpine
    restart: unless-stopped
    volumes:
      - pgdata:/var/lib/postgresql/data
    environment:
      - POSTGRES_USER=pankha
      - POSTGRES_PASSWORD=secure_password
      - POSTGRES_DB=db_pankha

volumes:
  pgdata:

Environment Configuration (.env)

The compose.yml relies on an .env file for secrets. You can download the default one:

wget https://github.com/Anexgohan/pankha/releases/latest/download/example.env -O .env

Or create it manually:

PANKHA_PORT=3143
DATABASE_URL=postgresql://pankha:secure_password@postgres:5432/db_pankha
...

Note: Change secure_password to a strong, unique password in both the postgres and app services.

Verification

Check that your containers are running:

docker compose ps

You should see an Up status for both the app and postgres containers.

---

Next Steps

Once your server is running, see Server-Configuration for environment settings and Agents-Linux or Agents-Windows to install agents on your systems.