Services¶

Changemaker Lite includes several powerful services that work together to provide a complete documentation and development platform. Each service is containerized and can be accessed through its dedicated port.

Available Services¶

Code Server ¶

Port: 8888 | Visual Studio Code in your browser for remote development - Full IDE experience - Extensions support - Git integration - Terminal access

Listmonk ¶

Port: 9000 | Self-hosted newsletter and mailing list manager - Email campaigns - Subscriber management - Analytics - Template system

PostgreSQL ¶

Port: 5432 | Reliable database backend - Data persistence for Listmonk - ACID compliance - High performance - Backup and restore capabilities

MkDocs Material ¶

Port: 4000 | Documentation site generator with live preview - Material Design theme - Live reload - Search functionality - Markdown support

Static Site Server ¶

Port: 4001 | Nginx-powered static site hosting - High-performance serving - Built documentation hosting - Caching and compression - Security headers

n8n ¶

Port: 5678 | Workflow automation tool - Visual workflow editor - 400+ integrations - Custom code execution - Webhook support

NocoDB ¶

Port: 8090 | No-code database platform - Smart spreadsheet interface - Form builder and API generation - Real-time collaboration - Multi-database support

Homepage ¶

Port: 3010 | Modern dashboard for all services - Service dashboard and monitoring - Docker integration - Customizable layout - Quick search and bookmarks

Service Architecture¶

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│   Homepage      │    │   Code Server   │    │     MkDocs      │
│     :3010       │    │     :8888       │    │     :4000       │
└─────────────────┘    └─────────────────┘    └─────────────────┘

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│ Static Server   │    │    Listmonk     │    │      n8n        │
│     :4001       │    │     :9000       │    │     :5678       │
└─────────────────┘    └─────────────────┘    └─────────────────┘

┌─────────────────┐    ┌─────────────────┐    ┌─────────────────┐
│     NocoDB      │    │ PostgreSQL      │    │ PostgreSQL      │
│     :8090       │    │ (listmonk-db)   │    │ (root_db)       │
└─────────────────┘    │     :5432       │    │     :5432       │
         │              └─────────────────┘    └─────────────────┘
         └──────────────────────────────────────────────────────┘

Getting Started¶

Start all services: docker compose up -d
Check service status: docker compose ps
View logs: docker compose logs [service-name]
Stop services: docker compose down

Service Dependencies¶

Listmonk depends on PostgreSQL (listmonk-db)
NocoDB depends on PostgreSQL (root_db)
Static Server serves content built by MkDocs
n8n can integrate with all other services
All services share the changemaker network

Environment Configuration¶

Services are configured through environment variables in your .env file:

# Port configurations
CODE_SERVER_PORT=8888
LISTMONK_PORT=9000
LISTMONK_DB_PORT=5432
MKDOCS_PORT=4000
MKDOCS_SITE_SERVER_PORT=4001
N8N_PORT=5678

# User and group IDs
USER_ID=1000
GROUP_ID=1000

# Database configuration
POSTGRES_USER=listmonk
POSTGRES_PASSWORD=your_password
POSTGRES_DB=listmonk

# n8n configuration
N8N_ENCRYPTION_KEY=your_encryption_key
[email protected]
N8N_USER_PASSWORD=your_password

Monitoring and Maintenance¶

Health Checks¶

# Check all services
docker compose ps

# Check specific service logs
docker compose logs listmonk-app
docker compose logs code-server

Updates¶

# Pull latest images
docker compose pull

# Restart with new images
docker compose down && docker compose up -d

Backups¶

PostgreSQL: Regular database backups
n8n: Export workflows and credentials
Code Server: Backup configuration and workspace
MkDocs: Version control your documentation

Troubleshooting¶

Common Issues¶

Port Conflicts: Ensure ports are not used by other applications
Permission Issues: Check USER_ID and GROUP_ID settings
Network Issues: Verify services can communicate through the changemaker network
Data Persistence: Ensure volumes are properly mounted

Getting Help¶

Check individual service documentation
Review container logs for error messages
Verify environment variable configuration
Test network connectivity between services