mirror of
https://github.com/nickyeoman/docker-compose-cookbooks.git
synced 2026-09-03 18:36:22 +00:00
71 lines
2.2 KiB
Markdown
71 lines
2.2 KiB
Markdown
# Monica Personal CRM
|
||
|
||
## Overview
|
||
|
||
Monica is an open-source personal relationship manager. This stack runs Monica with a MariaDB database.
|
||
|
||
## Project Details
|
||
|
||
- **Project Repository:** [https://github.com/monicahq/monica](https://github.com/monicahq/monica)
|
||
- **Container Image:** [Docker Hub](https://hub.docker.com/_/monica)
|
||
- **Documentation:** [https://www.monicahq.com/](https://www.monicahq.com/)
|
||
- **Reverse Proxy Port:** `80`
|
||
|
||
## Getting Started
|
||
|
||
1. Start the stack: `docker compose up -d`
|
||
2. Open http://localhost:${MONICA_PORT:-8081} in your browser
|
||
3. Follow the setup wizard
|
||
|
||
## Environment Variable Notes
|
||
|
||
VOL_PATH – base path for persistent data volumes
|
||
VOL_PROJECTS – base path for project directories
|
||
MONICA_IMAGE – Monica container image (default: monica:latest)
|
||
MONICA_RESTART – restart policy (default: unless-stopped)
|
||
MONICA_PORT – host port mapped to container port 80 (default: 8081)
|
||
MONICA_APP_ENV – application environment (default: production)
|
||
MONICA_DB_IMAGE – MariaDB container image (default: mariadb:11)
|
||
MONICA_DB_PASSWORD – Monica database password
|
||
MONICA_MYSQL_ROOT_PASSWORD – MariaDB root password
|
||
|
||
## Volume Notes
|
||
|
||
${VOL_PATH}/monica_dev/db – MariaDB data directory
|
||
${VOL_PATH}/monica_dev/storage – Monica storage (avatars, exports, etc.)
|
||
|
||
## Network Notes
|
||
|
||
Requires the external `proxy` network (Nginx Proxy Manager). An internal bridge network `internal` is created for inter-service communication.
|
||
|
||
## Docker Run
|
||
|
||
```bash
|
||
docker run -d \
|
||
--name monica \
|
||
-v ${VOL_PATH:-/data}/monica_dev/storage:/var/www/html/storage \
|
||
-e DB_HOST=monica-db \
|
||
-e DB_USERNAME=monica \
|
||
-e DB_PASSWORD=changeme \
|
||
-e DB_DATABASE=monica \
|
||
-e APP_ENV=production \
|
||
-p 8081:80 \
|
||
--network proxy \
|
||
monica:latest
|
||
```
|
||
|
||
## Additional Notes / Gotchas
|
||
|
||
- After making changes via the database, run `php artisan migrate` inside the Monica container to apply schema changes.
|
||
|
||
## Dockhand Stack, Deploy from Git
|
||
|
||
Cookbooks Repository
|
||
stackname: MONICA_DEV
|
||
Compose file path: monica_dev/compose.yaml
|
||
Additional env file (optional): monica_dev/sample.env
|
||
|
||
Then "Load" monica_dev/sample.env into the Environmental variables in dockhand
|
||
|
||
Create the Stack
|