5.5 KiB
5.5 KiB
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
changemakernetwork
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
N8N_USER_EMAIL=admin@example.com
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_IDandGROUP_IDsettings - Network Issues: Verify services can communicate through the
changemakernetwork - 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