# Introduction

Mastodon requires a server (physical or virtual), and it’s also highly recommended to use an S3 bucket to store all local/remote media. It also requires a lot of time, resources and mental energy.

Any cloud provider should be fine. Try to find something local to your region. I’m in Sydney, so I’m using Linode, and Wasabi because they have Sydney based data centers, and offer good prices.

## Introduction to Scaling

Mastodon is built around multiple pieces of technology, and each of them can be tweaked to improve performance.

Key themes of this document is to highlight bottle necks and allow for scaling. All of these services can be run from a single box, but we HIGHLY recommend splitting them up as you start to scale (as soon as you can afford it).

Firstly, Please read the blogs written by Gargon and the official documentation on scaling. We will be using these for future reference.

\
[https://blog.joinmastodon.org/2017/04/scaling-mastodon/<br>](https://blog.joinmastodon.org/2017/04/scaling-mastodon/)<https://docs.joinmastodon.org/admin/scaling/>\
<https://gist.github.com/Gargron/aa9341a49dc91d5a721019d9e0c9fd11>

## Mastodon: Piece by Piece

A stable and high user Mastodon instance is made up of multiple pieces which are all working together.

* Patreon (or similar) to cover operating costs.
* DNS for internet facing resources.
* Email provider to send signups/password resets and other notifications.
* Cloud Storage (S3 compatable) to store and serve media (images/videos/avatars/etc).
* CDN to store and server static resources (js/css/svg/etc).
* VMs to host the Web servers (Frontend/API/Streaming/etc)
* VMs to host the Sidekiq Queue worker processes.
* VMs to host the Databases (Postgres) and Cache (Redis).
* Additional VMs might be required for monitoring/metrics and reporting.

Each of these pieces can be tuned, and optimised for cost/performance. I will make recommendations for all of these.

<figure><img src="https://1044007049-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FPejQLDNaagNU0AEbyhAu%2Fuploads%2FJC6ACt9bpm0zjOHPcRQ6%2Fimage.png?alt=media&#x26;token=42f67f9a-4feb-4031-89cb-13dbb84bbc89" alt=""><figcaption><p>High Level diagram of Aus.Social (NOV 2022)</p></figcaption></figure>

<figure><img src="https://lh6.googleusercontent.com/_mWsfCArEKIr4YwIzI5t5X3yEwAa-XgUECQelS135_w6R6g60pAVbWIPuRE9Ob5Jdv2SNSkCIvnYfHDE421CNEyKMvRc5RWbPVgTAo-jc8u0jrE-l3GFW7TtyrB81JpsZHi-2LoU0CzMCm1a3mLLX9aCNDIonb_jtb-PhTUn0HjS9FwU3wp76ledOU9BPw" alt=""><figcaption><p>Generic diagram of a Mastodon Instance</p></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://bonusmastodon.aus.social/introduction.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.