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