docker/README.md

This repository helps you to set up a local Mobilizon and a local WordPress instance for developing within minutes.

Step by Step Guide

1. Requirements

• make
• docker and docker-compose
• mkcert to handle locally trusted SSL certificates.

2. Clone Mobilizon source

git clone https://framagit.org/framasoft/mobilizon.git mobilizon/mobilizon

3. Generate a SSL-cert

Generate a local SSL-certificate which is used for both WordPress and Mobilizon.

mkcert -install -cert-file certs/lan.pem -key-file certs/lan-key.pem wp.lan mz.lan

4. Add the two dummy domains to the /etc/hosts file on your machine:

127.0.0.1   wp.lan
127.0.0.1   mz.lan

5. Build Mobilizon

make setup

6. Start the docker containers

make start

7. Go to http://wp.lan and setup WordPress

Currently this has to be done manually:

• Go to http://wp.lan and enter dummy credentials.
• Install the WordPress plugins you need.

8. Create an administrator user for Mobilizon

docker-compose exec mobilizon mix mobilizon.users.new "your@email.com" --admin --password "mypassword"

9. Start developing and debuggin

Get the logs via

• docker-compose logs -f <container_name>
• make logs