Guides - Deploying Mastodon through the Linode Marketplace

Mastodon is an open-source and decentralized micro-blogging platform 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. Unlike Twitter, Mastodon is decentralized, meaning that its content is not maintained by a central authority.

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 Mastodon.social, 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.

Note About Email at Linode

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.

Note

The Mastodon Marketplace App requires a custom domain. After deploying Mastodon, see the instructions within the Configure Your Domain’s Name Servers section.

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.

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.

Note

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.

• Domain (required): The domain name you wish to use for the mastodon server, such as example.com.
• 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.

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.

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.

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

      1 2 3 4 5 6

      # BEGIN ANSIBLE MANAGED BLOCK # PSQL password password: WiLjKhJSZE01TW3AoqViN3Kglu2bidWt # Owner password password: 3c4a675311ee52c0c1d7173d5169a10d # END ANSIBLE MANAGED BLOCK

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 Instances.social by filling out the admin form.

Note

Currently, Linode does not manage software and systems updates for Marketplace Apps. It is up to the user to perform routine maintenance on software deployed in this fashion.

More Information

You may wish to consult the following resources for additional information on this topic. While these are provided in the hope that they will be useful, please note that we cannot vouch for the accuracy or timeliness of externally hosted materials.

• Mastodon Deployment Github Repository