Skip to main content

Self-Hosted Installation

Deploy Genum on your own infrastructure for complete control over your data and AI workflows.

Genum is available as an open-source, self-hosted solution that you can deploy using Docker Compose.

Prerequisites​

  • Docker Compose
  • At least 4GB of available RAM and 8GB of free disk space
  • (Optional) AI provider API keys (OpenAI, Anthropic, Gemini)

Quick Start​

1. Clone the Repository​

git clone https://github.com/GenumAI/genum.git
cd genum

2. Configure Environment Variables​

Create a .env file from the example:

cp .env.example .env

Add your AI provider keys (optional, but required for AI features):

OPENAI_KEY=your_openai_key_here
ANTHROPIC_KEY=your_anthropic_key_here
GEMINI_KEY=your_gemini_key_here

Note: You can add any combination of these keys. The application will work without them, but AI features won't be available.

3. Start the Application​

docker-compose up -d

This will build images, start databases, run migrations, and start all services.

4. Access the Application​

Common Operations​

View Logs​

# All services
docker-compose logs -f

# Specific service
docker-compose logs -f core

Stop Services​

docker-compose down

Restart Services​

docker-compose restart

Rebuild and Restart​

docker-compose up -d --build

Updating Genum​

To update to the latest version:

1. Pull Latest Images​

docker-compose pull

2. Restart Services​

docker-compose up -d

This will stop existing containers, start new ones with updated images, and run any new database migrations automatically.

3. Verify Update​

docker-compose ps
docker-compose logs -f

License​

Genum is distributed under the Business Source License 1.1 (BUSL).

Allowed​

  • ✔ Personal use
  • ✔ Educational use
  • ✔ Research and experimentation

Requires a Commercial License​

  • ❌ Any commercial use
  • ❌ Use inside a business or organization
  • ❌ Internal business automation
  • ❌ Enterprise deployment
  • ❌ Integration into SaaS, services, or commercial tools

For commercial licensing inquiries, contact: enterprise@rockit.consulting

Getting Help​