Skip to content

.examples

Directory actions

More options

Directory actions

More options

Latest commit

 

History

History

.examples

Folders and files

NameName
Last commit message
Last commit date

parent directory

..
full
full
 
 
full_v5
full_v5
 
 
maxsize
maxsize
 
 
nginx-proxy-self-signed-ssl
nginx-proxy-self-signed-ssl
 
 
nginx-proxy
nginx-proxy
 
 
raspberrypi
raspberrypi
 
 
simple
simple
 
 
supervisor
supervisor
 
 
readme.md
readme.md
 
 

readme.md

Docker examples for Monica

In this section you will find some examples about how to use monica's docker images.

Example Description
simple simple example that run a container.
full example that run fpm-alpine with nginx, redis, separate cron and queue containers, and uses secrets.
full_v5 example for v5 of monica (a.k.a chandler) that run fpm-alpine with nginx, redis, separate cron and queue containers, and uses secrets.
supervisor uses supervisor to run a cron and a queue inside your container.
nginx-proxy-self-signed-ssl shows you how to run monica with a self signed ssl certificate.
nginx-proxy shows you how to run monica with https and generate a Let's Encrypt certificate.
maxsize shows you how to adapt the max upload size of you php settings in the app container.
raspberrypi shows you how to host monica on a raspberry pi.

Run with docker-compose

Configuration (all versions)

First, download a copy of Monica example configuration file:

curl -sS https://raw.githubusercontent.com/monicahq/monica/4.x/.env.example -o .env

Open the file in an editor and update it for your own needs:

  • Set APP_KEY to a random 32-character string. You can for instance copy and paste the output of echo -n 'base64:'; openssl rand -base64 32.
  • Edit the MAIL_* settings to point to your own mailserver.
  • Set DB_* settings to point to your database configuration. If you don't want to set a db prefix, be careful to set DB_PREFIX= and not DB_PREFIX='' as docker will not expand this as an empty string.
  • Set DB_HOST=db or any name of the database container you will link to.

With supervisor

The supervisor examples shows you how to run monica with

  • a db container (mariadb:11)
  • an app container, which run supervisord to handle a web server/fpm, a cron, and a queue.

This let you use QUEUE_CONNECTION=database in your .env file.

With nginx proxy and a self-signed certificate

nginx-proxy-self-signed-ssl example shows you how to run monica with a self signed ssl certificate, to run the application in https mode.

Set VIRTUAL_HOST and SSL_SUBJECT with the right domain name, and update SSL_KEY, SSL_CSR, and SSL_CERT accordingly. This example generates a new self-signed certificate.

Your browser might warn you about security issue, as a self-signed certificate is not trusted in production mode. For a real domain certificate, see the next section.

With nginx proxy and a Let's Encrypt certificate

nginx-proxy example shows you how to run monica and generate a Let's Encrypt certificate for your domain.

Don't forget to set:

  • VIRTUAL_HOST and LETSENCRYPT_HOST with your domain
  • LETSENCRYPT_EMAIL with a valid email
  • APP_URL in your .env file with the right domain url

You may want to set APP_ENV=production to force the use of https scheme.

This example add a redis container, that can be used too, adding these variables to your .env file:

  • REDIS_HOST=redis: mandatory, where redis is the name of the redis container
  • CACHE_DRIVER=redis: to use redis as a cache table
  • QUEUE_CONNECTION=redis: to use redis as a queue table