]> git.r.bdr.sh - rbdr/blog.unlimited.pizza/blob - archive/1704232830490/notes-on-setting-up-a-mastodon-server.gmi
blog-sync-up-1704232830559
[rbdr/blog.unlimited.pizza] / archive / 1704232830490 / notes-on-setting-up-a-mastodon-server.gmi
1 # Notes on Setting Up a Mastodon Server
2
3 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.
4
5 => https://friendship.quest/@ruben [1] my profile @ friendship.quest
6
7 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.
8
9 => https://wiki.archlinux.org/title/Mastodon [2] Arch Wiki entry on Mastodon.
10 => https://glitch-soc.github.io/docs/ [3] Mastodon Glitch Edition
11 => https://aur.archlinux.org/packages/mastodon-git [4] mastodon-git AUR package.
12
13 Then onto the setup itself. Starting with the clone:
14
15 ```
16 % git clone https://aur.archlinux.org/packages/mastodon-git
17 ```
18
19 Then changed PKGBUILD to use the glitch-soc version.
20
21 ```
22 # -source=("git+https://github.com/tootsuite/${pkgname%-git}.git#branch=$_branch"
23 # +source=("git+https://github.com/glitch-soc/${pkgname%-git}.git#branch=$_branch"
24 ```
25
26 Installed some dependencies.
27
28 ```
29 % pacman -Sy imagemagick libpqxx postgresql redis protobuf nodejs icu cmake base-devel
30 ```
31
32 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.
33
34 => https://asdf-vm.com/ [5] asdf-vm
35
36 But then we were able to makepkg
37
38 ```
39 % makepkg -si
40 ```
41
42 The post-install instructions didn't run for me, so I read them from the file [6].
43
44 => https://aur.archlinux.org/cgit/aur.git/tree/mastodon.install?h=mastodon [6] mastodon.git post-install file
45
46 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.
47
48 => https://github.com/glitch-soc/mastodon/blob/main/lib/tasks/mastodon.rake [7] mastodon:setup rake task source
49
50 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.
51
52 => https://github.com/mastodon/mastodon/blob/main/dist/nginx.conf [8] nginx.conf from mastodon repo.
53
54 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.
55
56 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.
57
58 Finally, before migrating I imported a couple of ready-made blocklists and went over information on moderation.
59
60 => https://fedi.tips/importing-ready-made-server-blocklists-on-mastodon/ [9] fedi.tips info on blocklists
61
62 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.