This repository is designed to be read with my blog post, and you should be familiar with the first-party setup guide too.
It includes Nomad task definitions that I use to run my own Mastodon instance, as well as a couple of helpful scripts. They're tuned to run on a single t4g.medium server on AWS.
It's supposed to be for inspiration, rather than a step-by-step guide. You won't be able to run it out of the box using this repository, but I hope it's useful as a reference to get you started.
If you know of a better way to do something, or want to offer other improvements, please send me a message on Mastodon @carrot@bunny.cloud before opening a PR.
For interest, it's actually a redacted copy of the cluster folder, from a repository I use to manage the infrastructure for bunny.cloud. Not included are the terraform and ansible definitions for all the underlying infrastructure.
The Nomad task definitions include:
- A front proxy (nginx)
- Web server (Mastodon - Ruby on Rails)
- A message processor (Mastodon - Sidekiq)
- A streaming server (Mastodon - Node)
- A SQL migrations task (ran before every deploy)
- A periodic cleanup task (to remove old media)
install_dependencies.shinstalls local dependencies to run scriptsdeploy_cluster.shuses the Nomad CLI to deploy all the tasks./tootctl.shruns a giventootctlcommand in a running sidekiq allocation
🥕 carrot 🗂 bunny-cloud-infra/infra/cluster 🐙 main $ ./tootctl.sh version
Discovering alloc of "mastodon-sidekiq" to run tootctl in...
Found alloc with ID: ef0fd901-d598-9fe6-b2c2-3c577c0aee2e
Executing: "tootctl version"
4.0.2
Everything here is MIT licensed - use it, change it, and please credit me if you do something public with it.