mash-playbook/docs/services/mobilizon.md
2023-06-01 16:57:30 +02:00

49 lines
2.1 KiB
Markdown

# Mobilizon
[Mobilizon](https://joinmobilizon.org/en/) is a ActivityPub/Fediverse server to create and share events here powered by the [mother-of-all-self-hosting/ansible-role-mobilizon](https://github.com/mother-of-all-self-hosting/ansible-role-mobilizon) Ansible role.
## Depedencies
This service requires the following other services:
- a [Postgis](postgis.md) database (postgres based database that supports geospatial data)
- a [Traefik](traefik.md) reverse-proxy server
## Configuration
To enable this service, add the following configuration to your `vars.yml` file. Also you need to enable postgis which will serve as database for mobilizon.
After that you can re-run the [installation](../installing.md) process.
```yaml
########################################################################
# #
# mobilizon #
# #
########################################################################
mobilizon_enabled: true
# Hostname that this server will be reachable at.
# DO NOT change this after your server has already run once, or you will break things!
mobilizon_hostname: 'events.example.org'
# to open registrations uncomment the following line
# mobilizon_registrations_open: true
########################################################################
# #
# /mobilizon #
# #
########################################################################
```
After installation, you can use `just run-tags mobilizon-add-admin --extra-vars=password=<password> --extra-vars=email=<email>`
to create your an admin account.
### Usage
After [installing](../installing.md), you can visit at the URL specified in `mobilizon_hostname` and should see your instance.
Refer to the [great official documentation](https://docs.joinmobilizon.org/use/) for more information on Mobilizon.