Introduction
Imagine a world where you can post on your favorite social platform and reach friends on other networks without them needing to sign up anywhere new. That's the promise of the open social web—interoperability across services like Mastodon, Bluesky, and others. Yet, due to different underlying protocols (ActivityPub for the Fediverse and AT Protocol for Bluesky), cross-platform communication isn't automatic. The solution? A bridge. Bridging tools let you syndicate your content so that a single post can appear across multiple networks. This guide focuses on Bridgy Fed, the simplest bridge to connect Mastodon and Bluesky, and explains how you can set it up step by step. Whether you're embracing the POSSE philosophy (Publish Own Site, Syndicate Elsewhere) or just want to make your content accessible to a wider audience, this tutorial will get you there.
What You Need
- An active Mastodon account (or any Fediverse account; we'll use Mastodon for clarity)
- An active Bluesky account
- Access to the web or a Mastodon client (e.g., Mastodon Web, Tusky, or similar)
- A stable internet connection
Step-by-Step Instructions
Note: The steps below assume you already have both accounts. If not, create them first—Mastodon requires you to choose a server (instance), and Bluesky requires an invite code or direct sign-up depending on availability.
- Log into your Mastodon account. Open your preferred Mastodon client or web interface. Make sure you are logged in to the account you want to bridge.
- Search for the Bridge Account. In the search bar, type the exact handle:
@bsky.brid.gy@bsky.brid.gy. This is Bridgy Fed's Mastodon account that acts as the bridge. - Follow the Bridge Account. Once you locate it, click the Follow button. This triggers the bridging process. The bridge account will automatically follow you back within a few minutes.
- Wait for Confirmation. After you follow Bridgy Fed, it will follow you back. You'll receive a notification on Mastodon. This confirms the bridge is active.
- Test the Connection. Post something public on your Mastodon account. Within a short time (usually seconds to minutes), that same post should appear on your Bluesky account. Check your Bluesky timeline to verify. If it works, you're all set!
- Optional: Set Up Bluesky-to-Mastodon Bridging. To also have your Bluesky posts appear on Mastodon, repeat the process in reverse: on Bluesky, find and follow the handle
@bsky.brid.gy(or the appropriate Bridgy Fed account for Bluesky). Follow the instructions on Bridgy Fed's website for two-way bridging.
Tips & Best Practices
- Check Privacy Settings: Only public posts will bridge. Keep your account's default posting visibility set to public for maximum reach.
- Understand Delays: Bridging may take a few minutes due to processing. Be patient—it's not instant.
- Explore Other Bridges: Besides Bridgy Fed, services like Fedisky, RSS Parrot, and Pinhole offer similar functionality. Experiment to find what works best for you.
- Embrace POSSE: This bridging is part of the larger POSSE philosophy. Consider running your own website as a primary hub and syndicating out—this gives you full ownership of your content.
- Troubleshoot If It Fails: If posts don't appear, double-check that you followed the correct handle and that the bridge account followed you back. Also ensure your Mastodon server allows cross-instance following (most do).
- Stay Updated: The open social web evolves quickly. Follow the Bridgy Fed blog or Mastodon account for updates on features and changes.