Skip to main content

Open source and decentralized social networking platform.

Mastodon is used to create a social network based on open web standards and principles. Like Twitter, it lets users follow other users and post text, photos, and video content.

The Mastodon platform takes a federated approach to social networking. Each Mastodon instance operates independently — anyone can create an instance and build their community. Users from different instances can still follow each other, share content, and communicate. Mastodon participates in the Fediverse, a collection of social networks and other websites that communicate using the ActivityPub protocol. That allows different Mastodon instances to communicate and also allows other platforms in the Fediverse to communicate with Mastodon.

Mastodon servers range in size from small private instances to massive public instances and typically center on specific interests or shared principles. The biggest Mastodon server is, a general-interest server created by the developers of the Mastodon platform. It has over 540,000 users and boasts a thorough Code of Conduct.

Deploying a Marketplace App

The Linode Marketplace allows you to easily deploy software on a Compute Instance using the Cloud Manager. See Get Started with Marketplace Apps for complete steps.

  1. Log in to the Cloud Manager and select the Marketplace link from the left navigation menu. This displays the Linode Create page with the Marketplace tab pre-selected.
  2. Under the Select App section, select the app you would like to deploy.
  3. Complete the form by following the steps and advice within the Creating a Compute Instance guide. Depending on the Marketplace App you selected, there may be additional configuration options available. See the Configuration Options section below for compatible distributions, recommended plans, and any additional configuration options available for this Marketplace App.
  4. Click the Create Linode button. Once the Compute Instance has been provisioned and has fully powered on, wait for the software installation to complete. If the instance is powered off or restarted before this time, the software installation will likely fail.
  5. To verify that the app has been fully installed, see Get Started with Marketplace Apps > Verify Installation. Once installed, follow the instructions within the Getting Started After Deployment section to access the application and start using it.

Estimated deployment time: Mastodon should be fully installed within 10-15 minutes after the Compute Instance has finished provisioning.

  • Supported distributions: Debian 11
  • Recommended minimum plan: All plan types and sizes can be used.

This guide may involve or result in sending email. In an effort to fight spam, Linode restricts outbound connections on ports 25, 465, and 587 on all Linodes for new accounts created after November 5th, 2019. For more information, please see Sending Email on Linode.

Configuration Options

  • Domain (required): The domain name you wish to use for the mastodon server, such as
  • Linode API Token (required): A personal access token for your account. The Linode API is used to create DNS records for your custom domain through the DNS Manager. See Get an API Access Token.
  • Email for the Let’s Encrypt certificate (required): The email you wish to use when creating your TLS/SSL certificate through Let’s Encrypt. This email address receives notifications when the certificate needs to be renewed.
  • Username for the Mastodon Owner (required): The username for the Owner user that will be created for the Mastodon server.
  • Email Address for the Mastodon Owner (required): The contact email for the Mastodon server’s owner.
  • Single-user mode (required): Enabling Single User Mode prevents other users from joining the Mastodon Server.

Getting Started After Deployment

Configure Your Domain’s Name Servers

To use Mastodon with the custom domain you specified during deployment, you must configure the domain to use Linode’s name servers. This is typically accomplished directly through your registrar. See Use Linode’s Name Servers with Your Domain.

View the Mastodon Site

Open a web browser and navigate to the custom domain you entered when deploying Mastodon. This opens the Explore page in Mastodon, which displays public information about your site, public posts, and links to login or create an account.

Access Your Mastodon Account and Settings

1. Obtain and save passwords that were generated on your behalf during deployment, including your Mastodon user’s password.

  1. Log in to your new Compute Instance through Lish or SSH using the root user and the associated password you entered when creating the instance.
  2. The passwords have been saved in the /root/.deployment-secrets.txt file. You can view this file in your preferred text editor or through the cat command:

    cat /root/.deployment-secrets.txt

    The file contains your PSQL password and user’s (owner’s) password.
File: /root/.deployment-secrets.txt
# PSQL password
password: WiLjKhJSZE01TW3AoqViN3Kglu2bidWt
# Owner password
password: 3c4a675311ee52c0c1d7173d5169a10d

2. Log in to Mastodon. Within a web browser, navigate to https://[domain.tld]/auth/sign_in, replacing [domain.tld] with the custom domain you entered when deploying Mastodon. This opens the login page. Enter the owner’s email address you created and the password that you obtained in the previous step. Once logged in, your user’s home page is opened, which displays your own timeline, the post creation form, and links to navigate around.

3. Access admin settings. Navigate to https://[domain.tld]/admin/settings/ to view your site’s administration settings. The administration page allows you to alter the look, feel, and behavior of your site. Consider configuring each of these settings, including the site name, contact username, contact email, server description, and fields within other tabs.

4. The Mastodon instance also includes Sidekiq (background processing) and PgHero (a performance dashboard for Postgres). Both of these can be accessed through Mastodon Preferences page or by navigating to the following URLs:

Sidekiq: https://[domain.tld]/sidekiq

PgHero: https://[domain.tld]/pghero

5. The Mastodon server is configured to send emails for actions such as new users signing up or resetting a password. The installation includes only minimal DNS records and there may be limited deliverability without further configuration. Review the guide to Sending Email on Linode for more information on DNS configurations and email best practices.

To learn more about Mastodon, check out the official Mastodon blog with news and articles related to Mastodon. You can engage with the Mastodon administrative community on Mastodon’s discussion forum, where you can peruse conversations about technical issues and community governance. When you are ready to make your instance known to the world, you can add it to the list over at by filling out the admin form.

The Mastodon Marketplace app will install the latest version of Mastodon on your compute instance. As the user, it is your responsibility to update your version of Mastodon as needed. Follow this community tutorial.

The Mastodon Marketplace app was built by Linode. For support regarding app deployment, contact Linode Support. For support regarding the tool or software itself, visit Mastodon GitHub Discussions.