> ## Documentation Index
> Fetch the complete documentation index at: https://docs.trymondo.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Project overview

# Mondo MOPS (Mondo Open Platform Service)

**A privacy-first, self-hosted open platform for modern marketing teams and agencies.**

## What This Repo Contains

This repository contains the full deployment framework for the MOPS platform, including:

* **Core Marketing Services**: Mautic (email marketing), n8n (workflow automation), EspoCRM (customer relationship management), Outline (knowledge base), Cal.com (scheduling)
* **Infrastructure Configuration**: Traefik (reverse proxy), Docker Compose files, environment configurations
* **Monitoring & Management**: Loki/Grafana (logging), Backrest/Restic (backups), Portainer (container management)
* **Authentication & Security**: Authentik (identity provider), secure headers configuration

MOPS follows a modular architecture allowing teams to deploy only the services they need while maintaining a consistent management interface.

## Why Use Mondo MOPS?

* **100% Self-Hosted, Privacy-Respecting**: Complete control over your marketing data and infrastructure
* **Pre-Integrated Tools**: Carefully selected and configured marketing tools that work together seamlessly
* **Enterprise-Grade Infrastructure**: Built with Docker, Traefik, and modern DevOps practices for reliability
* **Consistent Environments**: Standardized development, staging, and production environments
* **Open Source Foundation**: Built on trusted open source technologies with active communities

## Getting Started

### Basic Requirements

* Cloud- or Self-Hosted VPS running Ubuntu 24.04 LTS
* Docker 24+ and Docker Compose
* Domain name with DNS control for subdomain routing
* 2GB+ RAM (4GB+ recommended for full stack)
* At least 20GB storage space

### Quick Start

1. Clone this repository
2. Configure your environment variables
3. Run the deployment script

For complete installation and deployment instructions, see the [Setup Documentation](./docs/setup/README.md).

## Repository Structure

```
MOPS/
├── docs/                    # Documentation
├── environments/            # Environment-specific configurations
│   ├── dev/                 # Development environment
│   ├── staging/             # Staging environment
│   └── prod/                # Production environment
│       ├── traefik/         # Reverse proxy configuration
│       ├── n8n/             # Workflow automation
│       ├── mautic/          # Email marketing platform
│       ├── espocrm/         # CRM platform
│       ├── outline/         # Knowledge base
│       └── ...              # Other services
├── shared/                  # Shared configurations and utilities
└── .github/
    └── workflows/           # CI/CD pipelines
```

## Services

| Service   | Description            | URL                      |
| --------- | ---------------------- | ------------------------ |
| Traefik   | Reverse Proxy & TLS    | traefik.trymondo.com     |
| Mautic    | Email Marketing        | outreach.trymondo.com    |
| n8n       | Automation Workflows   | automations.trymondo.com |
| EspoCRM   | CRM Platform           | crm.trymondo.com         |
| Outline   | Knowledge Base         | wiki.trymondo.com        |
| Portainer | Container Management   | portainer.trymondo.com   |
| Grafana   | Observability          | grafana.trymondo.com     |
| Cal.com   | Appointment Scheduling | cal.trymondo.com         |
| Homer     | Service Dashboard      | dash.trymondo.com        |
| FilePizza | File Sharing           | pizza.trymondo.com       |

## Development

!!! note

MOPS follows standardized naming conventions across environments. See [Naming Conventions](./docs/naming-conventions.md) for details.

For development guidelines, contribution workflows, and technical specifications, refer to the [Developer Documentation](./docs/development/README.md).

## License

Mondo MOPS is licensed under the MIT License. See [LICENSE](./LICENSE) for details.

***

Developed and maintained by \[