How to Enable Full-Text Search on a Mastodon Instance With Elasticsearch

Mastodon’s default search only finds exact usernames and hashtags. This limitation frustrates power users and community managers who need to locate posts by keywords or phrases across the federated timeline. The cause is that Mastodon stores posts in a PostgreSQL database without a full-text index by default. This article explains how to install and configure … Read more

Mastodon Instance With Docker Compose: Production Notes

Running a Mastodon instance with Docker Compose in a production environment requires more than just copying the default configuration files. Many administrators find their instance becomes slow, unresponsive, or suffers from database connection failures after a few days of live use. These problems usually stem from missing performance tuning, inadequate resource allocation, or incorrect volume … Read more

How to Apply Custom CSS Themes to a Mastodon Instance

Many Mastodon instance administrators want to give their community a unique look that stands out from the default interface. The stock Mastodon theme uses a clean blue-and-white design, but it may not match your brand or personal preference. Custom CSS themes let you change colors, fonts, spacing, and layout elements across the entire web interface. … Read more

Mastodon Instance Sign Up Approval Workflow for Admins

As a Mastodon instance administrator, you may want to control who can join your community to prevent spam, bots, or unwanted users. Mastodon provides a built-in sign-up approval workflow that lets you review and approve or reject new account requests before they gain access. This article explains how to enable the approval mode, manage pending … Read more

How to Audit Mastodon Instance Performance With Health Checks

Mastodon instances can slow down or become unresponsive without warning. You might notice the federated timeline loading slowly, posts failing to send, or the web interface timing out. These issues often stem from server resource strain, database bottlenecks, or failing background jobs. This article explains how to use Mastodon’s built-in health check endpoints and admin … Read more

Mastodon Instance Mail Delivery Not Working: SMTP Troubleshooting

When your Mastodon instance stops sending emails for password resets, confirmations, or notifications, users cannot complete registration or recover accounts. This problem usually stems from incorrect SMTP settings, firewall blocks, or authentication failures with your email provider. This article explains the common causes of SMTP mail delivery failures on Mastodon and provides step-by-step fixes to … Read more

How to Block Spam Sign Ups on a Public Mastodon Instance

Spam sign-ups are a persistent problem for public Mastodon instances. Automated bots and malicious actors create fake accounts to spread unwanted content, send direct message spam, and disrupt local timelines. This issue drains moderator time and can drive away legitimate users. This article explains how to configure Mastodon’s built-in anti-spam tools, set email domain blocks, … Read more

How Mastodon Federation Works: ActivityPub Explained Simply

Mastodon is part of a decentralized social network called the Fediverse, where different servers communicate by speaking the same language: ActivityPub. You may have noticed that you can follow users on other Mastodon instances or even on platforms like PeerTube and Pixelfed without leaving your home server. This article explains the technical concept of federation … Read more

Mastodon Federated Timeline Not Updating: Diagnostic Steps

When your Mastodon federated timeline stops showing new posts from other instances, the experience feels like the network has gone silent. This problem usually stems from a connectivity disruption between your home server and remote instances, a stalled background refresh process, or a local caching issue. This article explains the root causes of a frozen … Read more