# Notes on Setting Up a Mastodon Server

Last week I decided to migrate my account to my own mastodon server [1], and I was surprised at how easy it was, but it wasn't without hiccups so I'm writing down some notes on my experience on here. It's not meant to be an in-depth tutorial, but a rough overview on what I had to do to get the server to work.

=> https://friendship.quest/@ruben [1] my profile @ friendship.quest

First, some information on my setup: I have a VPS on digitalocean running arch linux, so I went directly to the Arch Wiki [2] which provides great documentation. I had my mind set on using the glitch fork of mastodon [3], so I went with the mastodon-git [4] package. I only had 1G of RAM, which absolutely won't work: some dependencies won't even compile without running out of memory. I decided to upgrade to an instance with 4GB, and this was enough though I did have to tweak some values.

=> https://wiki.archlinux.org/title/Mastodon [2] Arch Wiki entry on Mastodon.
=> https://glitch-soc.github.io/docs/ [3] Mastodon Glitch Edition
=> https://aur.archlinux.org/packages/mastodon-git [4] mastodon-git AUR package.

Then onto the setup itself. Starting with the clone:

```
% git clone https://aur.archlinux.org/packages/mastodon-git
```

Then changed PKGBUILD to use the glitch-soc version.

```
# -source=("git+https://github.com/tootsuite/${pkgname%-git}.git#branch=$_branch"
# +source=("git+https://github.com/glitch-soc/${pkgname%-git}.git#branch=$_branch"
```

Installed some dependencies.

```
% pacman -Sy imagemagick libpqxx postgresql redis protobuf nodejs icu cmake base-devel
```

At this point I ran into issues with yarn when running makepkg as I use asdf [5] to control my environment. The dependencies above install nodejs, but I wanted to use the one from asdf, so I had to make sure the paths were correct, otherwise I ran into issues with the right version of yarn. Eventually corepack enable did work. I'm skipping this here because I don't really remember and I don't think most people will haver these issues.

=> https://asdf-vm.com/ [5] asdf-vm

But then we were able to makepkg

```
% makepkg -si
```

The post-install instructions didn't run for me, so I read them from the file [6].

=> https://aur.archlinux.org/cgit/aur.git/tree/mastodon.install?h=mastodon [6] mastodon.git post-install file

Before running the mastodon rake file, I made sure to have the s3 bucket and smtp configuration ready (Will post the pulumi recipe for this in another post), and then the mastodon:setup rake task ran *almost* entirely, but failed during the assets:precompile phase so I had to continue from where it stopped by reading the source [7]. Since only setting up the admin user was left, I removed the rest of the code temporarily to run just that part of the task.

=> https://github.com/glitch-soc/mastodon/blob/main/lib/tasks/mastodon.rake [7] mastodon:setup rake task source

With that, all that was left was to set up nginx, so I used the file included in the repo [8] to set it up.

=> https://github.com/mastodon/mastodon/blob/main/dist/nginx.conf [8] nginx.conf from mastodon repo.

And that was pretty much it. I did have to make some changes to reduce memory usage and have sidekiq run correctly. On /lib/systemd/system/mastodon-sidekiq.service, I replaced -c 5 with -c 3 and made sure to include -q ingress and -q scheduler as they weren't included.

I won't go into detail here on the full text search setup, but I did have to reduce the max heap size on opensearch + reduce the sidekiq workers to 3 to avoid running out of memory. In /etc/opensearch/jvm.options you can set -Xms1g and -Xmx1g or whatever value works for you.

Finally, before migrating I imported a couple of ready-made blocklists and went over information on moderation.

=> https://fedi.tips/importing-ready-made-server-blocklists-on-mastodon/ [9] fedi.tips info on blocklists

The server worked well, though it did take about a day for federation to work reliably with some instances. I believe it had to do mostly with DNS propagation. Eventually I was able to migrate and so far it seems to be going well! I am now the proud owner of my personal mastodon instance.