Importing ready-made server blocklists on your own Mastodon server

Mastodon servers can choose to block other servers, and by default this is done manually one at a time. However, this can get cumbersome if there are lots of servers you need to block quickly, especially if you’re running a new server with no blocks at all yet.

To make the process easier, servers admins can download pre-written server-level blocklists. Blocklists on Mastodon are imported and exported as CSV files.

Where can I find ready-made blocklists?

The IFTAS Do Not Interact blocklist ⧉ and Garden Fence blocklist ⧉ are good simple starting points for blocking the very worst servers.

If you want a wider and more comprehensive range of ready-made blocklists, have a look at the links to lists on Pelago ⧉ and the links to lists on Oliphant.social ⧉.

How do I install ready-made blocklists on my server?

After you’ve downloaded the blocklist CSV files you want to use, here’s how to upload them to your server’s moderation system:

  1. Log in on your server’s website using your admin account.
  2. Go to Preferences > Moderation > Federation
  3. Click the Import button at the top
  4. Browse for the blocklist’s .csv file, then click Upload
  5. You will be presented with a list of servers to block. If there are servers with existing connections to your server, they will be automatically unticked. If you want to include these in the block, tick them.
  6. When you want to implement the blocklist, click Import in the top right corner of the list and click OK to confirm.

Once the list is successfully imported, the blocks will appear alongside your existing blocks. If necessary, you can remove blocks from the list just like any manually added block.

You can use several blocklists by just repeating the full import process for each blocklist file.

Will this block accounts that already have follows or followers with my server?

Before any blocks happen, the blocklist import process will highlight servers on the list that your server already has connections to. You will be given the option of either going ahead with blocking those servers, or leaving them off the blocklist. By default it will leave them off the blocklist, unless you choose to add them back in.

If you block a particular server, then all the follows and followers from that particular server will lose their connections to your server.

What happens to my existing blocklist?

All the servers you are blocking stay blocked. Uploading a ready-made blocklist adds more blocks, it doesn’t take any blocks away.

How reliable are ready-made blocklists?

Different blocklists have different methods for compiling them, which are usually stated next to their download links. You as admin need to judge which blocklist best suits your server.

Typically a ready-made blocklist might be compiled through some sort of vote by a pool of admins trusted by the blocklist compiler. Minimal blocklists might demand a very high number of admin votes before adding a server to the blocklist, while broad lists might block servers even after just a few votes.

If a blocklist doesn’t state any methodology, it might not be the most reliable blocklist.

How do I keep up to date with the latest version of a pre-made list?

At the moment on Mastodon you have to manually upload the latest version of a pre-made list to get the updated version. However, the official Mastodon roadmap ⧉ mentions plans for “shared block lists”, and there is an independent protocol called FIRES ⧉ to allow automatic distribution of blocklists and other information to Fediverse servers (Mastodon isn’t yet compatible with FIRES though).

What do I do if my server is on a blocklist incorrectly?

Contact the maintainer of the blocklist. Reputable blocklists will have a method for contacting the maintainer so that appeals for removal can be made.

↩ Back to the front page