59 lines
1.8 KiB
Markdown
59 lines
1.8 KiB
Markdown
This repository helps you to set up a local Mobilizon and a local WordPress instance for developing within minutes. It is still early alpha, if you should try it and get stuck somewhere it most likely our fault, so please reach out to us, and we try to help you.
|
|
|
|
## Step by Step Guide
|
|
|
|
### 0. Requirements
|
|
- `make`
|
|
- `docker` and `docker-compose`
|
|
- `mkcert` to handle locally trusted SSL certificates.
|
|
|
|
### 1. Fetch the repository
|
|
```bash
|
|
git clone https://code.event-federation.eu/Event-Federation/docker.git docker && cd docker
|
|
```
|
|
|
|
### 2. Clone Mobilizon source relative to this repo
|
|
We serve Mobilizon from source, because the latest patches needed are not included in the latest official Docker image.
|
|
```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
|
|
mkdir certs
|
|
mkcert -install -cert-file certs/lan.pem -key-file certs/lan-key.pem wp.lan mz.lan ga.lan
|
|
```
|
|
|
|
### 4. Add the two dummy domains to the /etc/hosts file on your machine:
|
|
`wp`: WordPress, `mz`: Mobilizon, `ga`: gancio
|
|
```
|
|
127.0.0.1 wp.lan
|
|
127.0.0.1 mz.lan
|
|
127.0.0.1 ga.lan
|
|
```
|
|
|
|
### 5. Build Mobilizon
|
|
```
|
|
make mobilizon
|
|
|
|
# Create an administrator user for Mobilizon
|
|
make mobilizon_admins
|
|
```
|
|
|
|
### 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 https://wp.lan and enter dummy credentials.
|
|
- Install the WordPress plugins you need.
|
|
|
|
|
|
### 8. Create an administrator user for Gancio
|
|
Just navigate to https://ga.lan. The first user registered will be site-administrator.
|
|
|
|
### 9. Start developing and debugging
|
|
Get the logs via
|
|
- `docker-compose logs -f <container_name>`
|
|
- `make logs`
|