{"id":55,"date":"2025-07-19T17:06:10","date_gmt":"2024-11-10T10:26:57","guid":{"rendered":""},"modified":"2025-02-02T00:46:14","modified_gmt":"2025-02-01T23:46:14","slug":"how-to-install-mastodon-social-network-on-debian-12","status":"publish","type":"post","link":"https:\/\/netcloud24.com\/knowledgebase\/how-to-install-mastodon-social-network-on-debian-12\/","title":{"rendered":"How to Install Mastodon Social Network on Debian 12"},"content":{"rendered":"<h2>Introduction<\/h2>\n<p>Mastodon is a free and open-source self-hosted social networking platform. This tutorial will guide you through the process of installing Mastodon on Debian 12.<\/p>\n<h2>Prerequisites<\/h2>\n<p>Before you begin, ensure you have:<\/p>\n<ol>\n<li>A Debian 12 server or virtual machine<\/li>\n<li>SSH access to the server<\/li>\n<li>Root or sudo privileges<\/li>\n<li>A domain name pointed to your server&#8217;s IP address (optional)<\/li>\n<\/ol>\n<h2>Step 1: Update System<\/h2>\n<p>Before installing any new software, it&#8217;s always a good idea to update the package repository and installed packages:<\/p>\n<pre><code>sudo apt update\r\nsudo apt upgrade -y\r\n<\/code><\/pre>\n<h2>Step 2: Install Dependencies<\/h2>\n<p>Install the required dependencies for Mastodon:<\/p>\n<pre><code>sudo apt install -y imagemagick ffmpeg libpq-dev libxml2-dev libxslt1-dev file git curl g++ libprotobuf-dev protobuf-compiler pkg-config nodejs gcc autoconf bison build-essential libssl-dev libyaml-dev libreadline-dev zlib1g-dev libncurses5-dev libffi-dev libgdbm6 libgdbm-dev nginx redis redis-server postgresql postgresql-contrib letsencrypt yarn\r\n<\/code><\/pre>\n<h2>Step 3: Set Up PostgreSQL<\/h2>\n<p>Create a PostgreSQL user and database for Mastodon:<\/p>\n<pre><code>sudo -u postgres createuser -s mastodon\r\nsudo -u postgres psql -c \"ALTER USER mastodon WITH PASSWORD 'your_password';\"\r\nsudo -u postgres createdb -O mastodon mastodon_production\r\n<\/code><\/pre>\n<h2>Step 4: Install Ruby<\/h2>\n<p>Install Ruby using rbenv:<\/p>\n<pre><code>git clone https:\/\/github.com\/rbenv\/rbenv.git ~\/.rbenv\r\necho 'export PATH=\"$HOME\/.rbenv\/bin:$PATH\"' &gt;&gt; ~\/.bashrc\r\necho 'eval \"$(rbenv init -)\"' &gt;&gt; ~\/.bashrc\r\nexec $SHELL\r\n\r\ngit clone https:\/\/github.com\/rbenv\/ruby-build.git ~\/.rbenv\/plugins\/ruby-build\r\necho 'export PATH=\"$HOME\/.rbenv\/plugins\/ruby-build\/bin:$PATH\"' &gt;&gt; ~\/.bashrc\r\nexec $SHELL\r\n\r\nrbenv install 3.0.2\r\nrbenv global 3.0.2\r\nruby -v\r\n<\/code><\/pre>\n<h2>Step 5: Install Mastodon<\/h2>\n<p>Clone the Mastodon repository:<\/p>\n<pre><code>git clone https:\/\/github.com\/tootsuite\/mastodon.git ~\/live\r\ncd ~\/live\r\n<\/code><\/pre>\n<p>Install Mastodon dependencies:<\/p>\n<pre><code>bundle install -j$(getconf _NPROCESSORS_ONLN) --deployment --without development test\r\nyarn install --pure-lockfile\r\n<\/code><\/pre>\n<h2>Step 6: Configure Mastodon<\/h2>\n<p>Generate Mastodon configuration files:<\/p>\n<pre><code>RAILS_ENV=production bundle exec rake mastodon:setup\r\n<\/code><\/pre>\n<p>Follow the on-screen prompts to configure Mastodon. Make sure to enter your domain name when prompted.<\/p>\n<h2>Step 7: Precompile Assets<\/h2>\n<p>Precompile Mastodon assets:<\/p>\n<pre><code>RAILS_ENV=production bundle exec rails assets:precompile\r\n<\/code><\/pre>\n<h2>Step 8: Set Up Nginx<\/h2>\n<p>Set up Nginx configuration for Mastodon:<\/p>\n<pre><code>sudo cp ~\/live\/dist\/nginx.conf \/etc\/nginx\/sites-available\/mastodon\r\nsudo ln -s \/etc\/nginx\/sites-available\/mastodon \/etc\/nginx\/sites-enabled\/mastodon\r\n<\/code><\/pre>\n<p>Open the Nginx configuration file and replace <code>example.com<\/code> with your domain name:<\/p>\n<pre><code>sudo nano \/etc\/nginx\/sites-available\/mastodon\r\n<\/code><\/pre>\n<p>Restart Nginx to apply the changes:<\/p>\n<pre><code>sudo systemctl restart nginx\r\n<\/code><\/pre>\n<h2>Step 9: Start Mastodon Services<\/h2>\n<p>Start Mastodon services:<\/p>\n<pre><code>cd ~\/live\r\nRAILS_ENV=production bundle exec sidekiq -c 5 -q default -q mailers -q pull -q push\r\nRAILS_ENV=production bundle exec puma -C config\/puma.rb\r\n<\/code><\/pre>\n<h2>Step 10: Set Up Let&#8217;s Encrypt SSL<\/h2>\n<p>Install Certbot for Let&#8217;s Encrypt:<\/p>\n<pre><code>sudo apt install certbot\r\n<\/code><\/pre>\n<p>Obtain SSL certificate for your domain:<\/p>\n<pre><code>sudo certbot --nginx -d your_domain_name\r\n<\/code><\/pre>\n<p>Follow the on-screen prompts to obtain and install the SSL certificate.<\/p>\n<h2>Step 11: Access Mastodon<\/h2>\n<p>Open a web browser and navigate to your Mastodon instance using your domain name:<\/p>\n<pre><code>https:\/\/your_domain_name\r\n<\/code><\/pre>\n<p>Follow the on-screen instructions to set up your Mastodon instance and create an administrator account.<\/p>\n<h2>Conclusion<\/h2>\n<p>Congratulations! You have successfully installed Mastodon Social Network on Debian 12. You can now customize your Mastodon instance and start connecting with others in the Fediverse.<\/p>\n<p><a href=\"https:\/\/de.netcloud24.com\/\" target=\"_blank\">Windows VPS Deutschland<\/a><\/p>\n<p><a href=\"https:\/\/es.netcloud24.com\/\" target=\"_blank\">Windows VPS Espa\u00f1a<\/a><\/p>\n<p><a href=\"https:\/\/nl.netcloud24.com\/\" target=\"_blank\">Windows VPS Nederland<\/a><\/p>\n<p><a href=\"https:\/\/it.netcloud24.com\/\" target=\"_blank\">Windows VPS Italia<\/a><\/p>\n<p><a href=\"https:\/\/pt.netcloud24.com\/\" target=\"_blank\">Windows VPS Portugal<\/a><\/p>\n<p><a href=\"https:\/\/it.netcloud24.com\/\" target=\"_blank\">VPS Windows Italia<\/a><\/p>\n<p><a href=\"https:\/\/ie.netcloud24.com\" target=\"_blank\">Windows VPS<\/a><\/p>\n<p><a href=\"https:\/\/ie.netcloud24.com\" target=\"_blank\">Windows VPS<\/a><\/p>\n<p><a href=\"https:\/\/ie.netcloud24.com\" target=\"_blank\">Windows VPS Sverige<\/a><\/p>\n<p><a href=\"https:\/\/ie.netcloud24.com\" target=\"_blank\">Windows VPS Norge<\/a><\/p>\n<p><a href=\"https:\/\/ie.netcloud24.com\" target=\"_blank\">Windows VPS<\/a><\/p>\n<p><a href=\"https:\/\/ie.netcloud24.com\" target=\"_blank\">Windows VPS T\u00fcrkiye<\/a><\/p>\n<p><a href=\"https:\/\/ie.netcloud24.com\" target=\"_blank\">Windows RDS (Remote Desktop Services)<\/a><\/p>\n<p><a href=\"https:\/\/ie.netcloud24.com\" target=\"_blank\">Windows VPS<\/a><\/p>\n<div class=\"post-author-box\" style=\"border-top:1px solid #ddd;margin-top:20px;padding-top:15px;\">\n<p><strong>Author:<\/strong> \u0141ukasz Bodziony<\/p>\n<p><strong>Website:<\/strong> <a href=\"https:\/\/ca.netcloud24.com\" target=\"_blank\" rel=\"dofollow\">Windows VPS<\/a><\/p>\n<p><em>\u0141ukasz Bodziony is the CEO and founder of <a href=\"https:\/\/netcloud24.com\" target=\"_blank\" rel=\"dofollow\">NETCLOUD24<\/a>, a global VPS hosting brand proudly originating from Poland. With extensive experience in cloud computing, virtualization, and server management, he delivers high-performance <strong>Windows VPS<\/strong> and <strong>Remote Desktop Services (RDS)<\/strong> solutions to clients across Europe, North America, and beyond.<\/em><\/p>\n<p><em>His expertise covers a wide range of technologies, including <strong>Microsoft Azure<\/strong>, <strong>Proxmox VE<\/strong>, <strong>Amazon Web Services (AWS)<\/strong>, and numerous other virtualization and cloud platforms.<\/em><\/p>\n<p><em>Beyond running his hosting business, \u0141ukasz also provides <strong>professional paid server configuration and optimization services<\/strong> for companies and individuals. Outside of work, he is dedicated to caring for his children and building a secure future for them.<\/em><\/p>\n<p><em>If you are interested in working with him or need expert assistance with your hosting, cloud environment, or server setup, feel free to reach out via <a href=\"https:\/\/ca.netcloud24.com\" target=\"_blank\" rel=\"dofollow\">Windows VPS<\/a>.<\/em><\/p>\n<\/p><\/div>\n","protected":false},"excerpt":{"rendered":"<p>Introduction Mastodon is a free and open-source self-hosted social networking platform. This tutorial will guide you through the process of installing Mastodon on Debian 12. Prerequisites Before you\u2026<\/p>\n","protected":false},"author":1,"featured_media":3421,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","footnotes":"","jetpack_publicize_message":"","jetpack_publicize_feature_enabled":true,"jetpack_social_post_already_shared":false,"jetpack_social_options":{"image_generator_settings":{"template":"highway","default_image_id":0,"font":"","enabled":false},"version":2}},"categories":[],"tags":[14,12,11,23,20,21,22,17,7,8,6,10,18,19,15,24,16,5,13,9],"class_list":["post-55","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","tag-cheapvps","tag-cloudvps","tag-hostingvps","tag-rds","tag-rdscal","tag-remotedesktop","tag-remotedesktopvps","tag-servervps","tag-ukvps","tag-virtualserver","tag-vpshosting","tag-vpsserver","tag-vpssolutions","tag-vpswindows","tag-vpswithwindows","tag-windowsrds","tag-windowsserver","tag-windowsvps","tag-windowsvpshosting","tag-windowsvpsuk"],"jetpack_publicize_connections":[],"_links":{"self":[{"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/55","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/comments?post=55"}],"version-history":[{"count":0,"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/posts\/55\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/media\/3421"}],"wp:attachment":[{"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/media?parent=55"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/categories?post=55"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/netcloud24.com\/knowledgebase\/wp-json\/wp\/v2\/tags?post=55"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}