docker/README.md

46 lines
1.2 KiB
Markdown

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 "password"
```
### 9. Start developing and debuggin
Get the logs via
- `docker-compose logs -f <container_name>`
- `make logs`