ehlxr/pleroma-docker
1
0
Fork 0
Code Issues Pull Requests Projects Releases Wiki Activity

Update 'README.md'

Browse Source
This commit is contained in:
sn0w 2021-03-25 10:14:55 +00:00
parent 298b6a3acc
commit a80d553d09
1 changed files with 21 additions and 23 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

44
README.md
View File

@ -26,7 +26,7 @@ This repository dockerizes it for easier deployment.
## In the Wild ## In the Wild
`cofe.rocks` is always managed by this script. `cofe.rocks` is always managed by this script.<br/>
Take a look at [hosted/pleroma](/hosted/pleroma) if you get stuck or need some inspiration. Take a look at [hosted/pleroma](/hosted/pleroma) if you get stuck or need some inspiration.
Additionally it's known to run on (in no particular order): Additionally it's known to run on (in no particular order):
@ -34,7 +34,7 @@ Additionally it's known to run on (in no particular order):
- social.technodruide.ca - social.technodruide.ca
- toot.poto.cafe - toot.poto.cafe
Does your instance use pleroma-docker? Does your instance use pleroma-docker?<br/>
Let me know and I'll add you to this list. Let me know and I'll add you to this list.
## Docs ## Docs
@ -64,55 +64,53 @@ For other problems related to this script, contact me or open an issue :)
- Profit! - Profit!
Hint: Hint:
You can also use normal `docker-compose` commands to maintain your setup. You can also use normal `docker-compose` commands to maintain your setup.<br/>
The only command that you cannot use is `docker-compose build` due to build caching. The only command that you cannot use is `docker-compose build` due to build caching.
### Configuration ### Configuration
All the pleroma options that you usually put into your `*.secret.exs` now go into `config.exs`. All the pleroma options that you usually put into your `*.secret.exs` now go into `config.exs`.<br/>
`.env` stores config values that need to be known at orchestration/build time.<br/>
`.env` stores config values that need to be known at orchestration/build time.
Documentation for the possible values is inside of that file. Documentation for the possible values is inside of that file.
### Updates ### Updates
Run `./pleroma.sh build` again and start the updated image with `./pleroma.sh up`. Run `./pleroma.sh build` again and start the updated image with `./pleroma.sh up`.<br/>
You don't need to stop your pleroma server for either of those commands. You don't need to stop your pleroma server for either of those commands.
### Maintenance ### Maintenance
Pleroma maintenance is usually done with mix tasks. Pleroma maintenance is usually done with mix tasks.<br/>
You can run these tasks in your running pleroma server using `./pleroma.sh mix [task] [arguments...]`. You can run these tasks in your running pleroma server using `./pleroma.sh mix [task] [arguments...]`.<br/>
For example: `./pleroma.sh mix pleroma.user new sn0w ...` For example: `./pleroma.sh mix pleroma.user new sn0w ...`<br/>
If you need to fix bigger problems you can also spawn a shell with `./pleroma.sh enter`. If you need to fix bigger problems you can also spawn a shell with `./pleroma.sh enter`.
### Customization ### Customization
Add your customizations (and their folder structure) to `custom.d/`. Add your customizations (and their folder structure) to `custom.d/`.<br/>
They will be copied into the right place when the container starts. They will be copied into the right place when the container starts.<br/>
You can even replace/patch pleroma’s code with this, You can even replace/patch pleroma’s code with this, because the project is recompiled at startup if needed.
because the project is recompiled at startup if needed.
In general: Prepending `custom.d/` to pleroma’s customization guides should work all the time. In general: Prepending `custom.d/` to pleroma’s customization guides should work all the time.<br/>
Check them out in the [pleroma documentation](https://docs.pleroma.social/small_customizations.html#content). Check them out in the [pleroma documentation](https://docs.pleroma.social/small_customizations.html#content).
For example: A custom thumbnail now goes into `custom.d/` + `instance/static/instance/thumbnail.jpeg`. For example: A custom thumbnail now goes into `custom.d/` + `instance/static/instance/thumbnail.jpeg`.
### Patches ### Patches
Works exactly like customization, but we have a neat little helper here. Works exactly like customization, but we have a neat little helper here.<br/>
Use `./pleroma.sh mod [regex]` to mod any file that ships with pleroma, without having to type the complete path. Use `./pleroma.sh mod [regex]` to mod any file that ships with pleroma, without having to type the complete path.
### My instance is up, how do I reach it? ### My instance is up, how do I reach it?
To reach Gopher or SSH, just uncomment the port-forward in your `docker-compose.yml`. To reach Gopher or SSH, just uncomment the port-forward in your `docker-compose.yml`.
To reach HTTP you will have to configure a "reverse-proxy". To reach HTTP you will have to configure a "reverse-proxy".<br/>
Older versions of this project contained a huge amount of scripting to support all kinds of reverse-proxy setups. Older versions of this project contained a huge amount of scripting to support all kinds of reverse-proxy setups.<br/>
This newer version tries to focus only on providing good pleroma tooling. This newer version tries to focus only on providing good pleroma tooling.<br/>
That makes the whole process a bit more manual, but also more flexible. That makes the whole process a bit more manual, but also more flexible.
You can use Caddy, Traefik, Apache, nginx, or whatever else you come up with. You can use Caddy, Traefik, Apache, nginx, or whatever else you come up with.<br/>
Just modify your `docker-compose.yml` accordingly. Just modify your `docker-compose.yml` accordingly.
One example would be to add an [nginx server](https://hub.docker.com/_/nginx) to your `docker-compose.yml`: One example would be to add an [nginx server](https://hub.docker.com/_/nginx) to your `docker-compose.yml`:
@ -136,13 +134,13 @@ Then take a look at [the pleroma nginx example](https://git.pleroma.social/plero
Using apache would work in a very similar way (see [Apache Docker Docs](https://hub.docker.com/_/httpd) and [the pleroma apache example](https://git.pleroma.social/pleroma/pleroma/blob/develop/installation/pleroma-apache.conf)). Using apache would work in a very similar way (see [Apache Docker Docs](https://hub.docker.com/_/httpd) and [the pleroma apache example](https://git.pleroma.social/pleroma/pleroma/blob/develop/installation/pleroma-apache.conf)).
The target that you proxy to is called `http://server:4000/`. The target that you proxy to is called `http://server:4000/`.<br/>
This will work automagically when the proxy also lives inside of docker. This will work automagically when the proxy also lives inside of docker.
If you need help with this, or if you think that this needs more documentation, please let me know. If you need help with this, or if you think that this needs more documentation, please let me know.
Something that cofe.rocks uses is simple port-forwarding of the `server` container to the host's `127.0.0.1`. Something that cofe.rocks uses is simple port-forwarding of the `server` container to the host's `127.0.0.1`.<br/>
From there on, the natively installed nginx server acts as a proxy to the open internet. From there on, the natively installed nginx server acts as a proxy to the open internet.<br/>
You can take a look at cofe's [compose yaml](/hosted/pleroma/src/branch/master/docker-compose.yml) and [proxy config](/hosted/pleroma/src/branch/master/proxy.xconf) if that setup sounds interesting. You can take a look at cofe's [compose yaml](/hosted/pleroma/src/branch/master/docker-compose.yml) and [proxy config](/hosted/pleroma/src/branch/master/proxy.xconf) if that setup sounds interesting.
### Attribution ### Attribution