Local Installation Guide

Step-by-step instructions to download and install CodeForge-AI on your local machine

System Requirements

Minimum Requirements

  • Docker 20.10+
  • 4GB RAM
  • 2 CPU cores
  • 10GB free disk space

Recommended

  • Docker 24.0+
  • 8GB RAM
  • 4 CPU cores
  • 20GB free disk space

Download

Docker Compose

Complete setup with all dependencies

Download

Source Code

Build from source for customization

GitHub

Binary Release

Pre-built binaries for quick setup

Download

Installation Steps

1

Download the Package

curl -L https://codeforge-ai.com/download/docker-compose.yml -o docker-compose.yml

Download the latest Docker Compose configuration file.

2

Configure Environment

cp .env.example .env

Copy the environment configuration file and update with your settings.

3

Start Services

docker-compose up -d

Launch all CodeForge-AI services in detached mode.

4

Verify Installation

docker-compose ps

Check that all services are running correctly.

5

Access Dashboard

http://localhost:8080

Open your browser and navigate to the local dashboard.

Configuration Details

Environment Variables

API_PORT=8080 DATABASE_URL=postgresql://user:pass@db:5432/codeforge REDIS_URL=redis://redis:6379 JWT_SECRET=your-secret-key

Services

  • API Server (Port 8080)
  • PostgreSQL Database
  • Redis Cache
  • Docker Engine

Troubleshooting

Port Conflicts

If port 8080 is already in use, modify the API_PORT in your .env file.

Docker Issues

Ensure Docker is running and you have sufficient permissions.

Memory Limits

Increase Docker memory allocation if containers fail to start.