{"id":17385,"date":"2023-08-31T12:26:46","date_gmt":"2023-08-31T10:26:46","guid":{"rendered":"https:\/\/contabo.com\/blog\/?p=17385"},"modified":"2023-09-01T10:55:58","modified_gmt":"2023-09-01T08:55:58","slug":"how-to-install-mastodon-on-vps","status":"publish","type":"post","link":"https:\/\/contabo.com\/blog\/how-to-install-mastodon-on-vps\/","title":{"rendered":"How to Run Your Own Mastodon Instance on a VPS?\u00a0"},"content":{"rendered":"\n
\n
\"How<\/figure>\n<\/figure>\n\n\n\n
<\/div>\n\n\n\n

 In our digital world where everybody shares almost every moment on Social Media, Mastodon is a cool alternative to platforms like Twitter (now called X). But what’s Mastodon? Well, it’s like a do-it-yourself Twitter that isn’t all about collecting your data \u2013 and the best about it: Because it\u2019s open-source it\u2019s completely free. This article will show you what Mastodon is, how it’s different from Twitter, and why it’s awesome to have your own Mastodon space. Plus, we’ll help you set up your own Mastodon on a Linux computer. <\/p>\n\n\n\n

The Decentralized Idea Behind Mastodon <\/h2>\n\n\n\n

At its heart, Mastodon isn’t just another social media platform; it’s a testament to the power of decentralization and community-driven development. Imagine a sprawling network of interconnected instances, each acting as an independent node, collectively forming the vast universe of Mastodon. Instead of a single monolithic platform with a central governing body, Mastodon is an ecosystem of micro-communities, where each instance can be tailored to its unique user base, content policies, and governance structure. This decentralized model inherently promotes user agency, privacy, and customization, fostering a digital landscape that reflects the diverse range of voices and interests in the real world. <\/p>\n\n\n\n

Mastodon vs. Twitter<\/h2>\n\n\n\n

In the world of social media, Mastodon stands out for its decentralized approach and focus on giving users more control. This is quite different from platform X, which used to be called Twitter. While X has a lot of users and is well-known, it’s tangled up in challenges like keeping user data private, not being clear about how their algorithms work, and having a central authority control all activity on the platform. On the other hand, Mastodon’s way of working is more community-driven and puts users in charge. X’s algorithms can make certain posts more visible, which leads to worries about people only hearing similar opinions and biases in the algorithms. In Mastodon, posts just show up in the order they were made, which keeps things open and encourages real conversations. Plus, Mastodon’s setup lets users and administrators customize the platform, build local communities, and handle content rules themselves. <\/p>\n\n\n\n

Benefits of Hosting Your Own Mastodon Instance <\/h2>\n\n\n\n

When it comes to diving into the Mastodon social network, you’ve got choices: hop onto an existing instance or set up your own instance. Let’s break it down. Joining an existing instance can be like moving into a ready-made neighborhood – you’re part of an existing community right away. But there are limits to how much you can customize things. On the flip side, hosting your own instance gives you a world of benefits. You get to be the boss of your Mastodon world – you can make it look and work just how you want. You’re in charge of the rules, which means you can make it a friendly and cozy space for you and your friends, free from any unwanted noise. Plus, your data is in your hands, so no worries about privacy.<\/p>\n\n\n\n

Creating Your Own Mastodon Server <\/h2>\n\n\n\n

As we delve deeper into this article, you’ll learn how to turn this vision into reality by installing your very own Mastodon instance on a Linux server with Debian 11. This journey will equip you with the tools and insights needed to navigate the technical aspects of setting up and maintaining a self-hosted Mastodon instance, allowing you to carve out your digital haven in the vast expanse of the decentralized social web. <\/p>\n\n\n\n

Prerequisites <\/h2>\n\n\n\n

Before you dive into setting up your own Mastodon instance, there are a few key prerequisites to bear in mind. Firstly, you’ll need a server with Debian 11 or Ubuntu 20.04 on it to host your Mastodon instance. A suitable domain is also required. Luckily, we at Contabo offer both! Click here<\/a> if you need a Domain (.com-Domains start at \u20ac1.99!). If you need a fitting server, we got you covered as well! Depending on the number of users and general activity on your instance you may need different amounts of RAM, CPU-cores and storage space. Our VPS M SSD<\/a> offers a great starting tier for your Mastodon journey. We also offer VPS with different configurations here<\/a>. <\/p>\n\n\n\n

Installation of Mastodon on Debian 11 <\/h2>\n\n\n\n

Let’s roll up our sleeves and get into the nitty-gritty of installing Mastodon on a Debian 11 Linux server. Follow these steps to bring your instance to life: <\/p>\n\n\n\n

Update System Packages <\/h3>\n\n\n\n

Begin by updating your system’s package list and upgrading any existing packages: <\/p>\n\n\n\n

apt update\u00a0\napt upgrade<\/code><\/pre>\n\n\n\n
Install System Repositories:<\/h3>\n\n\n\n
Make sure curl, wget, gnupg, apt-transport-https, lsb-release and ca-certificates is installed first because these packages are required to continue: <\/p>\n\n\n\n
apt install -y curl wget gnupg apt-transport-https lsb-release ca-certificates <\/code><\/pre>\n\n\n\n
Install NodeJS <\/h3>\n\n\n\n
Now it\u2019s time to install NodeJS to handle Mastodon’s JavaScript dependencies: <\/p>\n\n\n\n
curl -sL https:\/\/deb.nodesource.com\/setup_16.x | bash - <\/code><\/pre>\n\n\n\n
Install PostgreSQL <\/h3>\n\n\n\n
As the database software PostgreSQL is required. Install it with these two commands: <\/p>\n\n\n\n
wget -O \/usr\/share\/keyrings\/postgresql.asc https:\/\/www.postgresql.org\/media\/keys\/ACCC4CF8.asc <\/code><\/pre>\n\n\n\n
echo \"deb [signed-by=\/usr\/share\/keyrings\/postgresql.asc] http:\/\/apt.postgresql.org\/pub\/repos\/apt $(lsb_release -cs)-pgdg main\" > \/etc\/apt\/sources.list.d\/postgresql.list <\/code><\/pre>\n\n\n\n
Install Other Required Packages <\/h3>\n\n\n\n
Because Mastodon is a complex piece of software, many packages are required for it to run. Install them all together with this big command: <\/p>\n\n\n\n
apt install -y \\ \n\n  imagemagick ffmpeg libpq-dev libxml2-dev libxslt1-dev file git-core \\ \n\n  g++ libprotobuf-dev protobuf-compiler pkg-config nodejs gcc autoconf \\ \n\n  bison build-essential libssl-dev libyaml-dev libreadline6-dev \\ \n\n  zlib1g-dev libncurses5-dev libffi-dev libgdbm-dev \\ \n\n  nginx redis-server redis-tools postgresql postgresql-contrib \\ \n\n  certbot python3-certbot-nginx libidn11-dev libicu-dev libjemalloc-dev<\/code><\/pre>\n\n\n\n
Enable Yarn <\/h3>\n\n\n\n
Enable Yarn with this command: <\/p>\n\n\n\n
corepack enable <\/code><\/pre>\n\n\n\n
And set Yarn\u2019s version: <\/p>\n\n\n\n
yarn set version classic <\/code><\/pre>\n\n\n\n
Install Ruby <\/h3>\n\n\n\n
Because .rbenv must be installed for a single Linux user we will create a Mastodon user with disabled login before we can start with the actual installation of Ruby: <\/p>\n\n\n\n
adduser --disabled-login mastodon <\/code><\/pre>\n\n\n\n
Now lets switch to the mastodon user with this command: <\/p>\n\n\n\n
su \u2013 mastodon <\/code><\/pre>\n\n\n\n
Now lets start with the actual installation of Ruby by executing these commands, command after command: <\/p>\n\n\n\n
git clone https:\/\/github.com\/rbenv\/rbenv.git ~\/.rbenv <\/code><\/pre>\n\n\n\n
cd ~\/.rbenv && src\/configure && make -C src <\/code><\/pre>\n\n\n\n
echo 'export PATH=\"$HOME\/.rbenv\/bin:$PATH\"' >> ~\/.bashrc <\/code><\/pre>\n\n\n\n
echo 'eval \"$(rbenv init -)\"' >> ~\/.bashrc <\/code><\/pre>\n\n\n\n
exec bash <\/code><\/pre>\n\n\n\n
git clone https:\/\/github.com\/rbenv\/ruby-build.git ~\/.rbenv\/plugins\/ruby-build <\/code><\/pre>\n\n\n\n
RUBY_CONFIGURE_OPTS=--with-jemalloc rbenv install 3.2.2 <\/code><\/pre>\n\n\n\n
Don\u2019t worry: This step will take AGES!<\/em> <\/p>\n\n\n\n
rbenv global 3.2.2 <\/code><\/pre>\n\n\n\n
gem install bundler --no-document <\/code><\/pre>\n\n\n\n
Before proceeding with the setup of PostgreSQL we will switch back to the root user with the following command: <\/p>\n\n\n\n
exit <\/code><\/pre>\n\n\n\n
Setting up PostgreSQL <\/h3>\n\n\n\n
It\u2019s time to create a database for our Mastodon instance. This can be done with these commands: <\/p>\n\n\n\n
sudo -u postgres psql <\/code><\/pre>\n\n\n\n
CREATE USER mastodon CREATEDB; <\/code><\/pre>\n\n\n\n
And now exit PostgreSQL: <\/p>\n\n\n\n
\\q<\/code><\/pre>\n\n\n\n
Setting up Mastodon <\/h3>\n\n\n\n
Switch to the mastodon user once again: <\/p>\n\n\n\n
su \u2013 mastodon <\/code><\/pre>\n\n\n\n
And download and install the required files: <\/p>\n\n\n\n
git clone https:\/\/github.com\/mastodon\/mastodon.git live && cd live <\/code><\/pre>\n\n\n\n
git checkout $(git tag -l | grep -v 'rc[0-9]*$' | sort -V | tail -n 1) <\/code><\/pre>\n\n\n\n
bundle config deployment 'true' <\/code><\/pre>\n\n\n\n
bundle config without 'development test' <\/code><\/pre>\n\n\n\n
bundle install -j$(getconf _NPROCESSORS_ONLN) <\/code><\/pre>\n\n\n\n
yarn install --pure-lockfile <\/code><\/pre>\n\n\n\n
Now start the installation setup with this command: <\/p>\n\n\n\n
RAILS_ENV=production bundle exec rake mastodon:setup <\/code><\/pre>\n\n\n\n
Here you will create a configuration file, run the asset precompilation, create the database scheme and create your admin account as well as set a few other options e.g. if you want to enable registrations on your instance. The setup process is very straightforward. <\/p>\n\n\n\n
Setting Up a Reverse Proxy with Nginx <\/h3>\n\n\n\n
cp \/home\/mastodon\/live\/dist\/nginx.conf \/etc\/nginx\/sites-available\/mastodon <\/code><\/pre>\n\n\n\n
nano \/etc\/nginx\/sites-available\/mastodon <\/code><\/pre>\n\n\n\n
Add the following two lines after this part: <\/p>\n\n\n\n
\"How<\/figure>\n\n\n\n
ssl_certificate \/etc\/ssl\/certs\/ssl-cert-snakeoil.pem;\nssl_certificate_key \/etc\/ssl\/private\/ssl-cert-snakeoil.key; <\/code><\/pre>\n\n\n\n
Now save the file with [CTRL] <\/strong>+ [O]<\/strong> and exit the editor with [CTRL]<\/strong> + [X] <\/strong><\/p>\n\n\n\n
It should look like this: <\/p>\n\n\n\n
\"How<\/figure>\n\n\n\n
Now activate the config with this command: <\/p>\n\n\n\n
ln -s \/etc\/nginx\/sites-available\/mastodon \/etc\/nginx\/sites-enabled\/mastodon <\/code><\/pre>\n\n\n\n
systemctl reload nginx <\/code><\/pre>\n\n\n\n
Install an SSL Certficiate <\/h3>\n\n\n\n
To make our Mastodon instance more secure we will install a free SSL certificate with certbot. This will install Let\u2019s Encrypt certificates for our instance. Have you ever asked yourself what SSL certificates are and how they \u2013 and the whole process actually works? Check out our detailed guide on SSL here<\/a>. <\/p>\n\n\n\n
certbot --nginx -d [your-domain]<\/code><\/pre>\n\n\n\n
Start the Mastodon Service <\/h3>\n\n\n\n
cp \/home\/mastodon\/live\/dist\/mastodon-*.service \/etc\/systemd\/system\/ <\/code><\/pre>\n\n\n\n
$EDITOR \/etc\/systemd\/system\/mastodon-*.service <\/code><\/pre>\n\n\n\n
systemctl daemon-reload <\/code><\/pre>\n\n\n\n
systemctl enable --now mastodon-web mastodon-sidekiq mastodon-streaming <\/code><\/pre>\n\n\n\n
Now wait one minute until everything is set up and then enter your domain in the browser. <\/p>\n\n\n\n
You will be greeted by this homescreen: <\/p>\n\n\n\n
\"\"<\/figure>\n\n\n\n
Congrats! <\/strong>You\u2019ve successfully installed your own Mastodon instance on your server. Have fun inviting friends and customizing your social media experience. Learn more about how to customize Mastodon on their official documentation here<\/a>.<\/p>\n","protected":false},"excerpt":{"rendered":"
Learn step-by-step how to set up and run your personal Mastodon instance on a VPS, gaining full control over your social media experience.<\/p>\n","protected":false},"author":50,"featured_media":17386,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"inline_featured_image":false,"_uag_custom_page_level_css":"","site-sidebar-layout":"default","site-content-layout":"","ast-site-content-layout":"default","site-content-style":"default","site-sidebar-style":"default","ast-global-header-display":"","ast-banner-title-visibility":"","ast-main-header-display":"","ast-hfb-above-header-display":"","ast-hfb-below-header-display":"","ast-hfb-mobile-header-display":"","site-post-title":"","ast-breadcrumbs-content":"","ast-featured-img":"","footer-sml-layout":"","theme-transparent-header-meta":"","adv-header-id-meta":"","stick-header-meta":"","header-above-stick-meta":"","header-main-stick-meta":"","header-below-stick-meta":"","astra-migrate-meta-layouts":"set","ast-page-background-enabled":"default","ast-page-background-meta":{"desktop":{"background-color":"var(--ast-global-color-4)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"ast-content-background-meta":{"desktop":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"tablet":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""},"mobile":{"background-color":"var(--ast-global-color-5)","background-image":"","background-repeat":"repeat","background-position":"center center","background-size":"auto","background-attachment":"scroll","background-type":"","background-media":"","overlay-type":"","overlay-color":"","overlay-opacity":"","overlay-gradient":""}},"footnotes":""},"categories":[18],"tags":[],"ppma_author":[1491],"class_list":["post-17385","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-tutorials"],"uagb_featured_image_src":{"full":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/08\/blog-head_how2-run-your-own-mastodon-server.jpg",1200,630,false],"thumbnail":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/08\/blog-head_how2-run-your-own-mastodon-server-150x150.jpg",150,150,true],"medium":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/08\/blog-head_how2-run-your-own-mastodon-server-600x315.jpg",600,315,true],"medium_large":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/08\/blog-head_how2-run-your-own-mastodon-server-768x403.jpg",768,403,true],"large":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/08\/blog-head_how2-run-your-own-mastodon-server.jpg",1200,630,false],"1536x1536":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/08\/blog-head_how2-run-your-own-mastodon-server.jpg",1200,630,false],"2048x2048":["https:\/\/contabo.com\/blog\/wp-content\/uploads\/2023\/08\/blog-head_how2-run-your-own-mastodon-server.jpg",1200,630,false]},"uagb_author_info":{"display_name":"Tobias Mildenberger","author_link":"https:\/\/contabo.com\/blog\/author\/tobias\/"},"uagb_comment_info":0,"uagb_excerpt":"Learn step-by-step how to set up and run your personal Mastodon instance on a VPS, gaining full control over your social media experience.","authors":[{"term_id":1491,"user_id":50,"is_guest":0,"slug":"tobias","display_name":"Tobias Mildenberger","avatar_url":"https:\/\/secure.gravatar.com\/avatar\/077178d5dce6c3d4c0c0396857a7e544bfdf8adf04145fff5160b33a22e28b1f?s=96&d=mm&r=g","0":null,"1":"","2":"","3":"","4":"","5":"","6":"","7":"","8":""}],"_links":{"self":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/17385","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/users\/50"}],"replies":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/comments?post=17385"}],"version-history":[{"count":3,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/17385\/revisions"}],"predecessor-version":[{"id":17426,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/posts\/17385\/revisions\/17426"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/media\/17386"}],"wp:attachment":[{"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/media?parent=17385"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/categories?post=17385"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/tags?post=17385"},{"taxonomy":"author","embeddable":true,"href":"https:\/\/contabo.com\/blog\/wp-json\/wp\/v2\/ppma_author?post=17385"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}