docs(): update readme

pull/26/head
Hardware 2018-01-30 21:35:42 +01:00
parent a4e57065b7
commit c722bab23e
No known key found for this signature in database
GPG Key ID: EC6DF6F90263EDEA
1 changed files with 75 additions and 39 deletions

View File

@ -46,7 +46,7 @@ Flarum is the next-generation forum software that makes online discussion fun. I
#### 1 - Pull flarum image #### 1 - Pull flarum image
``` ```bash
# Pull from hub.docker.com : # Pull from hub.docker.com :
docker pull mondedie/docker-flarum:0.1.0-beta.7.1-stable docker pull mondedie/docker-flarum:0.1.0-beta.7.1-stable
@ -54,40 +54,74 @@ docker pull mondedie/docker-flarum:0.1.0-beta.7.1-stable
docker build -t mondedie/docker-flarum https://github.com/mondediefr/flarum.git#master docker build -t mondedie/docker-flarum https://github.com/mondediefr/flarum.git#master
``` ```
#### 2 - Docker-compose.yml #### 2 - Docker-compose.yml example
Adapt to your needs : This is an Out-of-box setup example, adapt to your needs :
``` ```yml
flarum: version: "3"
services:
flarum:
image: mondedie/docker-flarum:0.1.0-beta.7.1-stable image: mondedie/docker-flarum:0.1.0-beta.7.1-stable
container_name: flarum container_name: flarum
links: labels:
- mariadb:mariadb - traefik.enable=true
- traefik.backend.port=8888
- traefik.frontend.rule=Host:flarum.local
environment: environment:
- FORUM_URL=https://forum.domain.tld - FORUM_URL=http://flarum.local
- DB_PASS=xxxxxxxx - DB_PASS=xxxxxx
volumes: volumes:
- /mnt/docker/flarum/assets:/flarum/app/assets - /mnt/docker/flarum/assets:/flarum/app/assets
- /mnt/docker/flarum/extensions:/flarum/app/extensions - /mnt/docker/flarum/extensions:/flarum/app/extensions
depends_on:
- mariadb
mariadb: mariadb:
image: mariadb:10.1 image: mariadb:10.1
container_name: mariadb container_name: mariadb
volumes:
- /mnt/docker/mysql/db:/var/lib/mysql
environment: environment:
- MYSQL_ROOT_PASSWORD=xxxxxxxx - MYSQL_ROOT_PASSWORD=xxxxxx
- MYSQL_DATABASE=flarum - MYSQL_DATABASE=flarum
- MYSQL_USER=flarum - MYSQL_USER=flarum
- MYSQL_PASSWORD=xxxxxxxx - MYSQL_PASSWORD=xxxxxx
volumes:
- /mnt/docker/mysql/db:/var/lib/mysql
traefik:
image: traefik
container_name: traefik
ports:
- "80:80"
volumes:
- /var/run/docker.sock:/var/run/docker.sock:ro
- /mnt/docker/traefik.toml:/traefik.toml:ro
``` ```
#### 4 - Reverse proxy setup ```toml
# /mnt/docker/traefik.toml
See : https://github.com/mondediefr/flarum/wiki/Reverse-proxy-example defaultEntryPoints = ["http"]
#### 5 - Done, congratulation ! :tada: [entryPoints]
[entryPoints.http]
address = ":80"
[docker]
endpoint = "unix:///var/run/docker.sock"
domain = "local"
watch = true
exposedbydefault = false
```
```bash
# /etc/hosts
127.0.0.1 flarum.local
```
#### 3 - Run it
You can now run Flarum : You can now run Flarum :
@ -95,6 +129,18 @@ You can now run Flarum :
docker-compose up -d docker-compose up -d
``` ```
And open http://flarum.local and fill out the installation form :
* Your admin password must contain at least **8 characters**.
* You can't use MariaDB **10.2** or **10.3** for the moment. More information on this issue [here](https://github.com/flarum/core/issues/1211).
* If you get an error 500 with _Something went wrong_ message, switch the `DEBUG` environment variable to `true` to see the actual error message in your browser.
![flarum-installation](http://i.imgur.com/e3Hscp4.png)
Click on **Install Flarum** and after few seconds the forum homepage should appear.
![flarum-home](http://i.imgur.com/6kH9iTV.png)
### Upgrade from v0.1.0-beta.6 ### Upgrade from v0.1.0-beta.6
:warning: Disable 3rd party extensions prior to upgrading. :warning: Disable 3rd party extensions prior to upgrading.
@ -141,7 +187,7 @@ docker exec -ti flarum extension list
To use custom error pages, add your .html files in `/mnt/docker/flarum/assets/errors` folder : To use custom error pages, add your .html files in `/mnt/docker/flarum/assets/errors` folder :
``` ```bash
mkdir -p /mnt/docker/flarum/assets/errors mkdir -p /mnt/docker/flarum/assets/errors
touch 403.html 404.html 500.html 503.html touch 403.html 404.html 500.html 503.html
chown -R 991:991 /mnt/docker/flarum chown -R 991:991 /mnt/docker/flarum
@ -158,14 +204,4 @@ my_public_repo|{"type":"vcs","url":"https://github.com/my/repo"}
https://getcomposer.org/doc/03-cli.md#modifying-repositories https://getcomposer.org/doc/03-cli.md#modifying-repositories
### Screenshot
#### Installation
:warning: **Admin password must contain at least 8 characters.**
![flarum-installation](http://i.imgur.com/e3Hscp4.png)
#### Home page
![flarum-home](http://i.imgur.com/6kH9iTV.png)