Add Mastodon installation docs
This commit is contained in:
parent
8ba2db78d7
commit
fb17e59d77
1 changed files with 35 additions and 0 deletions
35
docs/administration/mastodon.md
Normal file
35
docs/administration/mastodon.md
Normal file
|
@ -0,0 +1,35 @@
|
|||
# Installing Soapbox over Mastodon
|
||||
|
||||
It is possible to run Soapbox as your main frontend on top of Mastodon.
|
||||
This will replace the homepage and all static pages with Soapbox, using Mastodon only as the API.
|
||||
|
||||
To do so, shell into your server and unpack Soapbox:
|
||||
|
||||
```sh
|
||||
mkdir -p /opt/soapbox
|
||||
|
||||
curl -L https://gitlab.com/soapbox-pub/soapbox-fe/-/jobs/artifacts/develop/download?job=build-production -o soapbox-fe.zip
|
||||
|
||||
busybox unzip soapbox-fe.zip -o -d /opt/soapbox
|
||||
```
|
||||
|
||||
Now create an Nginx file for Soapbox with Mastodon.
|
||||
If you already have one, replace it:
|
||||
|
||||
```sh
|
||||
curl https://gitlab.com/soapbox-pub/soapbox-fe/-/raw/develop/installation/mastodon.conf > /etc/nginx/sites-available/mastodon
|
||||
```
|
||||
|
||||
Edit this file and replace all occurrences of `example.com` with your domain name.
|
||||
Uncomment the SSL lines if you've enabled SSL, otherwise do that first.
|
||||
|
||||
Finally, ensure the file is symlinked, then restart Nginx:
|
||||
|
||||
```sh
|
||||
ln -s /etc/nginx/sites-available/mastodon /etc/nginx/sites-enabled/mastodon
|
||||
|
||||
systemctl restart nginx
|
||||
```
|
||||
|
||||
If all is well, hopefully this worked!
|
||||
If not, run `nginx -t` to see if anything is amiss, and try reviewing Mastodon's [install guide](https://docs.joinmastodon.org/admin/install/).
|
Loading…
Reference in a new issue