2017-11-24 16:52:16 +00:00
|
|
|
# mastible
|
|
|
|
|
An Ansible playbook to install Mastodon
|
2017-11-27 02:33:19 +00:00
|
|
|
|
2017-11-27 13:38:44 +00:00
|
|
|
## Requirements
|
|
|
|
|
|
2020-08-23 00:43:49 +00:00
|
|
|
- Latest stable version of Ansible
|
|
|
|
|
- Server(s) running Ubuntu 16.04/18.04/20.04 LTS for hosting Mastodon
|
|
|
|
|
|
|
|
|
|
## Testing status
|
|
|
|
|
|
2020-08-23 00:52:46 +00:00
|
|
|
Mastible was tested on 20/08/2020 with Ansible 2.9.12 running against
|
|
|
|
|
a Ubuntu 20.04 server.
|
2017-11-27 13:38:44 +00:00
|
|
|
|
2018-08-25 16:09:50 +00:00
|
|
|
## Instructions for running this playbook (first time install)
|
2017-11-27 02:33:19 +00:00
|
|
|
|
2017-11-27 17:25:20 +00:00
|
|
|
- Copy group_vars/all.sample to group_vars/all and edit it to specify the
|
2018-08-24 03:36:02 +00:00
|
|
|
database name you wish to use with Mastodon. LOCAL_DOMAIN value is mandatory, it is your instance domain/sub-domain. **The PostgreSQL database role
|
2017-11-27 17:25:20 +00:00
|
|
|
will drop this database in preparation for Mastodon's database setup so make
|
|
|
|
|
sure this is not a database you are currently using**
|
2017-11-27 13:38:44 +00:00
|
|
|
- Copy roles/mastodon-config/templates/.env.production.sample to
|
|
|
|
|
roles/mastodon-config/templates/.env.production, edit with all
|
2018-08-24 03:36:02 +00:00
|
|
|
relevant details.
|
2018-08-24 03:33:50 +00:00
|
|
|
- Make a hosts file that looks like this:
|
2017-11-27 02:33:19 +00:00
|
|
|
|
|
|
|
|
```
|
|
|
|
|
[mastodon]
|
|
|
|
|
dev.example.social
|
|
|
|
|
```
|
2018-08-25 16:09:50 +00:00
|
|
|
- Run the playbook with `ansible-playbook -i hosts --extra-vars='install=true' site.yml`
|
|
|
|
|
|
|
|
|
|
## Instructions for using this playbook to update an existing instance
|
|
|
|
|
|
|
|
|
|
- Update version number in roles/mastodon-app/tasks/main.yml
|
2017-11-27 02:33:19 +00:00
|
|
|
- Run the playbook with `ansible-playbook -i hosts site.yml`
|
2018-08-25 16:09:50 +00:00
|
|
|
(**Note the lack of the install variable which is needed for installation related tasks**)
|
