Monica is a personal CRM (Customer Relationship Manager) designed to help you manage and enhance personal relationships. It tracks interactions, reminders, notes, and important dates, allowing you to stay connected with the people in your life. This guide details the Docker Compose setup for hosting Monica with an Apache backend and MariaDB database.
app (Monica Application):
8080 of the host machine.db (MariaDB Database):
http://<server-ip>:8080.version: '3.8'
services:
app:
image: monicahq/monica:latest
container_name: monica_app
depends_on:
- db
ports:
- "8080:80" # Map Apache's default port to host's port 8080
environment:
APP_ENV: production
DB_CONNECTION: mysql
DB_HOST: db
DB_PORT: 3306
DB_DATABASE: monica
DB_USERNAME: monica
DB_PASSWORD: secretpassword # Replace with a strong password
LOG_CHANNEL: stderr
CACHE_DRIVER: database
SESSION_DRIVER: database
QUEUE_DRIVER: sync
volumes:
- data:/var/www/html/storage
restart: unless-stopped
db:
image: mariadb:latest
container_name: monica_db
environment:
MYSQL_RANDOM_ROOT_PASSWORD: 'true' # Secure random root password
MYSQL_DATABASE: monica
MYSQL_USER: monica
MYSQL_PASSWORD: secretpassword # Replace with a strong password
volumes:
- mysqldata:/var/lib/mysql
restart: unless-stopped
volumes:
data:
mysqldata:
app)monicahq/monica:latest ensures the latest stable release.80) to 8080 on the host for external access.DB_HOST=db, DB_PORT=3306).CACHE_DRIVER) and session management (SESSION_DRIVER) ensure stability and scalability.QUEUE_DRIVER=sync) simplifies deployment for small-scale setups.db)mariadb:latest provides a stable and efficient database backend.monica user and database with a password for secure, dedicated access.Prepare Your Environment:
docker-compose.yml file.Save the Compose File:
docker-compose.yml file.Start the Services:
docker-compose up -d
Access Monica:
http://<server-ip>:8080
First-Time Setup:
To update Monica to the latest version:
docker-compose pull
docker-compose up -d
Ensure regular backups of both the application and database data:
# Backup application data
tar -czvf monica-data-backup.tar.gz /var/lib/docker/volumes/data/_data
# Backup MariaDB database
docker exec monica_db mysqldump -u monica -p monica > monica-db-backup.sql
Restore from backups if needed:
# Restore application data
tar -xzvf monica-data-backup.tar.gz -C /var/lib/docker/volumes/data/_data
# Restore database
docker exec -i monica_db mysql -u monica -p monica < monica-db-backup.sql
Secure Credentials:
secretpassword with a strong, unique password..env file instead of directly in the docker-compose.yml.Enable HTTPS:
Monitor Resources:
Test Updates:
With this setup, Monica CRM becomes a powerful addition to your home lab, enabling you to better manage your personal and professional relationships. Let me know if you need assistance with customization or troubleshooting! 🚀