Forge DevOps

Deployment, infrastructure, and CI/CD for the Forge platform.

Overview

This repo contains everything needed to deploy the Forge platform:

• Docker Compose configuration (production + development)
• Nginx reverse proxy
• SSL/TLS (Let's Encrypt)
• Backup/restore scripts
• CI/CD pipeline configuration
• Health check scripts
• Receptor mesh configuration

Quick Start

# 1. Clone the repo
git clone https://github.com/forgeplatform/forge-devops.git
cd forge-devops

# 2. Configure environment
cp .env.example .env
# Edit .env with real values

# 3. Start
docker compose up -d

# 4. Check health
./scripts/healthcheck-web.sh

Architecture

┌──────────────┐     ┌───────────────┐
│ forge-backend│     │ forge-frontend│
│   (Django)   │     │   (React)     │
└──────┬───────┘     └──────┬────────┘
       │                     │
       ▼                     ▼
┌─────────────────────────────────────┐
│          Docker Registry            │
└─────────────────┬───────────────────┘
                  │
                  ▼
       ┌─────────────────┐
       │   forge-devops   │
       │ docker-compose   │
       └────────┬────────┘
                │
    ┌───────────┼───────────┐
    ▼           ▼           ▼
┌────────┐ ┌────────┐ ┌────────┐
│ nginx  │ │postgres│ │ redis  │
└────────┘ └────────┘ └────────┘

Services

Service	Image	Port	Description
nginx	nginx:latest	443, 80	Reverse proxy, SSL termination
forge-web	ghcr.io/forgeplatform/forge-backend	8013	Django API + uWSGI
forge-task	ghcr.io/forgeplatform/forge-backend	-	Celery worker + Dispatcher
postgres	postgres:15	5432	Database
redis	redis:7	6379	Cache + message broker

Structure

forge-devops/
├── docker-compose.yml       # Production stack
├── docker-compose.dev.yml   # Development stack
├── docker/                  # Dockerfile templates
├── nginx/                   # Nginx configuration + SSL
├── receptor/                # Receptor mesh configuration
├── scripts/                 # Backup, restore, health checks
├── settings/                # Django production settings
├── docs/                    # All documentation
├── .env.example             # Environment template
└── .github/workflows/       # GitHub Actions CI/CD

Documentation

Deployment

• Architecture Overview
• Docker Deployment
• CI/CD Pipeline
• CI Pipeline Reference
• Contributing Guide

Plans

• Separation Plan
• Development Plan
• Detailed Plan
• Future Development
• Chat/AI Assistant Plan
• Mobile App Plan

Release

• Release Notes v2026.03.0
• Start & Run Guide

Backup & Restore

# Backup
./scripts/backup.sh

# Restore
./scripts/restore.sh /path/to/backup.sql.gz

Related Repositories

• forge-backend — Django API + Task Engine
• forge-frontend — React UI

Project History

The Forge platform is a modernized fork of Ansible AWX, licensed under the Apache License 2.0. See forge-backend/NOTICE for full attribution.

License

Licensed under the Apache License, Version 2.0. See LICENSE.