Skip to content

Latest commit

 

History

History
67 lines (43 loc) · 3.3 KB

readme.md

File metadata and controls

67 lines (43 loc) · 3.3 KB
Raw

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.
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