Installation

Installation

Codexa is distributed as a Docker image and is the recommended way to run it.

Requirements

• Docker and Docker Compose
• Node.js ≥ 18 (only if building from source)

Quick Start with Docker

1. Copy the sample compose file

cp docker-compose.sample.yaml docker-compose.yaml

2. Generate a strong JWT secret

# Using Node.js:
node -e "console.log(require('crypto').randomBytes(64).toString('hex'))"

# Or using OpenSSL:
openssl rand -hex 64

Paste the output into docker-compose.yaml as the value of JWT_SECRET.

3. Start the container

docker compose up -d

Codexa will be available at http://localhost:3000.

Register the first account after startup — there is no default admin password.