Getting Started - Intelligo LMS

Quick Start with Docker

The fastest way to try Intelligo is with Docker Compose. This sets up the LMS, database, and AI hives with a single command.

# Clone the repository
git clone https://github.com/senuamedia/intelligo.git
cd intelligo

# Start with Docker Compose
docker-compose up -d

# Open in browser
open http://localhost:3000

Default credentials: admin@example.com / admin123

Change default credentials

The default admin password should be changed immediately after first login. Go to Settings → Profile → Change Password.

Requirements

For self-hosted deployments, ensure your server meets these requirements:

Minimum (up to 100 users)

2 CPU cores
4 GB RAM
20 GB storage
Docker 20.10+

Recommended (100-1,000 users)

4 CPU cores
8 GB RAM
100 GB storage
Docker 20.10+

Production (1,000+ users)

8+ CPU cores
16+ GB RAM
500+ GB storage
GPU for AI (optional)

AI Acceleration

NVIDIA GPU with CUDA
Apple Silicon (M1/M2/M3)
Intel Xeon with AVX-512
CPU-only mode available

Installation Steps

Install Simplex Toolchain

Intelligo is built on Simplex. Install the Simplex toolchain first.

curl -sSf https://simplex.senuamedia.com/install.sh | sh

Clone Repository

Clone the Intelligo repository from GitHub.

git clone https://github.com/senuamedia/intelligo.git
cd intelligo

Configure Environment

Copy the example configuration and customize for your environment.

cp .env.example .env
# Edit .env with your settings

Build and Run

Build the project and start the server.

modulus build --release
./target/release/intelligo serve

Initialize Database

Run migrations and create the initial admin account.

./target/release/intelligo db migrate
./target/release/intelligo admin create

Configuration

Key configuration options in .env:

# Server Configuration
INTELLIGO_HOST=0.0.0.0
INTELLIGO_PORT=3000
INTELLIGO_BASE_URL=https://learn.example.com

# Database
DATABASE_URL=postgres://user:pass@localhost:5432/intelligo

# Storage
STORAGE_DRIVER=s3
S3_BUCKET=intelligo-content
S3_REGION=us-east-1

# AI Configuration
AI_ENABLED=true
AI_MODEL_PATH=/models
AI_GPU_ENABLED=true

# Email
SMTP_HOST=smtp.example.com
SMTP_PORT=587
SMTP_USER=notifications@example.com

# Authentication
AUTH_SESSION_SECRET=your-secret-key
AUTH_SESSION_TIMEOUT=3600

Kubernetes Deployment

For production deployments, use the Helm chart for Kubernetes:

# Add the Helm repository
helm repo add senuamedia https://charts.senuamedia.com
helm repo update

# Install Intelligo
helm install intelligo senuamedia/intelligo \
  --namespace learning \
  --create-namespace \
  --set ingress.host=learn.example.com \
  --set postgresql.enabled=true \
  --set ai.enabled=true

AWS S3 Static Hosting

This marketing site is hosted on S3 at intelligo.senuamedia.com. To deploy your own marketing site:

# Sync to S3 bucket
aws s3 sync . s3://intelligo.senuamedia.com \
  --exclude ".git/*" \
  --delete

# Invalidate CloudFront cache (if using CDN)
aws cloudfront create-invalidation \
  --distribution-id EXXX \
  --paths "/*"

Next Steps

Explore Features

Learn about courses, assessments, AI tutoring, and more.

Configure Security

Set up SSO, roles, and permissions for your organization.

Join Community

Contribute, report issues, and get help from other users.