114 lines
4.0 KiB
Markdown
114 lines
4.0 KiB
Markdown
---
|
|
template: home.html
|
|
hide:
|
|
- navigation
|
|
- toc
|
|
---
|
|
|
|
# Welcome to Changemaker Lite
|
|
|
|
Stop feeding your secrets to corporations. Own your political infrastructure.
|
|
|
|
## Quick Start
|
|
|
|
Get up and running in minutes:
|
|
|
|
```bash
|
|
# Clone the repository
|
|
git clone https://gitea.bnkops.com/admin/changemaker.lite
|
|
cd changemaker.lite
|
|
|
|
# Configure environment
|
|
./config.sh
|
|
|
|
# Start all services
|
|
docker compose up -d
|
|
|
|
# For production deployment with Cloudflare tunnels
|
|
./start-production.sh
|
|
```
|
|
|
|
## Services
|
|
|
|
Changemaker Lite includes these essential services:
|
|
|
|
### Core Services
|
|
|
|
- **[Homepage](services/homepage.md)** (Port 3010) - Central dashboard and service monitoring
|
|
- **[Code Server](services/code-server.md)** (Port 8888) - VS Code in your browser
|
|
- **[MkDocs](services/mkdocs.md)** (Port 4000) - Documentation with live preview
|
|
- **[Static Server](services/static-server.md)** (Port 4001) - Production documentation site
|
|
|
|
### Communication & Automation
|
|
|
|
- **[Listmonk](services/listmonk.md)** (Port 9000) - Newsletter and email campaign management
|
|
- **[n8n](services/n8n.md)** (Port 5678) - Workflow automation platform
|
|
|
|
### Data & Development
|
|
|
|
- **[NocoDB](services/nocodb.md)** (Port 8090) - No-code database platform
|
|
- **[PostgreSQL](services/postgresql.md)** (Port 5432) - Database backend for Listmonk
|
|
- **[Gitea](services/gitea.md)** (Port 3030) - Self-hosted Git service
|
|
|
|
### Interactive Tools
|
|
|
|
- **[Map Viewer](services/map.md)** (Port 3000) - Interactive map with NocoDB integration
|
|
- **[Mini QR](services/mini-qr.md)** (Port 8089) - QR code generator
|
|
|
|
## Getting Started
|
|
|
|
1. **Setup**: Run `./config.sh` to configure your environment
|
|
2. **Launch**: Start services with `docker compose up -d`
|
|
3. **Dashboard**: Access the Homepage at [http://localhost:3010](http://localhost:3010)
|
|
4. **Production**: Deploy with Cloudflare tunnels using `./start-production.sh`
|
|
|
|
## Project Structure
|
|
|
|
```
|
|
changemaker.lite/
|
|
├── docker-compose.yml # Service definitions
|
|
├── config.sh # Configuration wizard
|
|
├── start-production.sh # Production deployment script
|
|
├── mkdocs/ # Documentation source
|
|
│ ├── docs/ # Markdown files
|
|
│ └── mkdocs.yml # MkDocs configuration
|
|
├── configs/ # Service configurations
|
|
│ ├── homepage/ # Homepage dashboard config
|
|
│ ├── code-server/ # VS Code settings
|
|
│ └── cloudflare/ # Tunnel configurations
|
|
├── map/ # Map application
|
|
│ ├── app/ # Node.js application
|
|
│ ├── Dockerfile # Container definition
|
|
│ └── .env # Map configuration
|
|
└── assets/ # Shared assets
|
|
├── images/ # Image files
|
|
├── icons/ # Service icons
|
|
└── uploads/ # Listmonk uploads
|
|
```
|
|
|
|
## Key Features
|
|
|
|
- 🐳 **Fully Containerized** - All services run in Docker containers
|
|
- 🔒 **Production Ready** - Built-in Cloudflare tunnel support for secure access
|
|
- 📦 **All-in-One** - Everything you need for documentation, development, and campaigns
|
|
- 🗺️ **Geographic Data** - Interactive maps with real-time location tracking
|
|
- 📧 **Email Campaigns** - Professional newsletter management
|
|
- 🔄 **Automation** - Connect services and automate workflows
|
|
- 💾 **Version Control** - Self-hosted Git repository
|
|
- 🎯 **No-Code Database** - Build applications without programming
|
|
|
|
## System Requirements
|
|
|
|
- **OS**: Ubuntu 24.04 LTS (Noble Numbat) or compatible Linux distribution
|
|
- **Docker**: Version 24.0+ with Docker Compose v2
|
|
- **Memory**: Minimum 4GB RAM (8GB recommended)
|
|
- **Storage**: 20GB+ available disk space
|
|
- **Network**: Internet connection for initial setup
|
|
|
|
## Learn More
|
|
|
|
- [Getting Started](build/index.md) - Detailed installation guide
|
|
- [Services Overview](services/index.md) - Deep dive into each service
|
|
- [Blog](blog/index.md) - Updates and tutorials
|
|
- [GitHub Repository](https://gitea.bnkops.com/admin/Changemaker) - Source code
|