2023-01-11 00:00:00

Communications|Media|Technologyfediverse|Mastodon|migration|move|server|social media|transfer

How to migrate to another Mastodon server

So I decided to move to a new Mastodon server (also known as an instance) that had terms better suitable for one of our foreign language blogs. It is really amazing that a migration function even exists in a social media service. Normally services do everything they can to lock users into the platform, but Mastodon and other fediverse services are different. Moving to another service is documented, and doable in 30 minutes. Here is how to do it with Mastodon.

Even if you have been a casual user of a Mastodon service, you have all kinds of data stored on your account. You probably want to backup and save all existing data on your own computer, and then migrate it to a new server. Your posts are an exception - they can be saved but not transferred to a another server. In summary, the data that can be saved consists of:

  • Posts: the messages and the media files.
  • Followers: the list of accounts who are following you.
  • Following: the list of accounts you follow.
  • Blocked and muted: the lists of accounts you have blocked or muted.
  • Lists: lists that let you categorize who you are following.
  • Favorites, Bookmarks.

First, make sure you are ready for the migration

Log in to your old Mastodon server where all your data is stored, and:

  • Go to your Profile.
  • Select Preferences - Import and Export - Data export.
  • Click the button Request your archive. It will take a moment - depending on the amount of messages you have on your account - and you will receive an email message when the data is ready for download. The package (a JSON file) includes your messages and media files alone.
  • Download every list that you want to move to the new server. For instance, if you want to move the list of accounts you are following, click the CSV button on the same line. Save the file on your computer. Note that the list of people who are following you is transferred during the migration process automatically.

If you haven't created an account to the new server, do it now. Here you can find Mastodon servers to choose from. You can use the same handle that you have on the old server (it is because the full id is unique, something like @handle@old.server and @handle@new.server). Log in to the new server.

The migration process

The migration from an old Mastodon server to a new one is a relatively straightforward job if you carefully pay attention what you should do on the new server and what on the old server.

Step 1:

  • On your new server, open your Profile.
  • Select Preferences - Account.
  • Scroll down to Moving from a different account.
  • Click create an account alias.
  • Enter the full handle (something like @handle@old.server) of your account on the old server, and click Create Alias.

Step 2:

  • On your old server, open your Profile.
  • Select Preferences - Account.
  • Scroll down to Move to a different account.
  • Click configure it here.
  • Under the title Handle of the new account type the full handle of your new account (like @handle@new.server).
  • Under the title Current Password type the password of your old server account.
  • Click the Move Followers -button.

Step 3:

  • On your new server, open your Profile.
  • Select Preferences - Import and Export - Import.
  • Import Type is a drop down-menu where you can select which lists you want to import to the new server. For instance, choose the Following list for importing people who you have been following on the old server.
  • Click Browse-button below the Data title to choose the correct CSV file on your computer.
  • Click Upload to import the selected list.
mastodon data import screen capture

Verify these items after the migration

View your Profile on the new server, and you may notice some items are missing. Check that your avatar logo is there, as well as the description fields that display information about you to visitors.

Verify that the list of people you follow is as it should be, and check that your followers are there as well.

If you haven't yet written any posts on the new server, your feed is empty. Mastodon doesn't migrate your old posts to the new server. However, if you followed the instructions all your posts are saved on your computer as an JSON file. It is a structured data file that is normally accessed by programs only, but it can be viewed on the screen. For instance, Firefox browser comes with a built-in JSON file viewer. Simply open the JSON file in the browser. The JSON organization provides an online file viewer here.

The result

After a successful migration, you have an account on the new server with your followers, people you are following, the list of blocked accounts, and with other lists you saved on the old server. Your profile is up to date. Your own timeline of posts is empty, so that's something to do next.

Your old account still exists on the old sever, but you can only access the Account and Import/Export features.


More information about the migration is available in Mastodon documentation and in Fabrizio's blog.

of Innsbruck in Austria

2025-09-02 17:49:48

of Innsbruck in Austria


News

2025-08-31 15:29:00

But these so-called “bad” photographs that break all the rules aren’t just trending; these “terrible” photographs are what’s going to save photography from AI. #photography #AI--- hmm, I don't think AI can be dismissed so easily; new skills can be taughthttps://www.digitalcameraworld.com/tech/artificial-intelligence/terrible-images-are-going-to-save-photography-from-ai-and-this-is-why


City center.

2025-08-27 16:57:04

arihak

City center.


News

2025-08-25 15:56:00

Looks like #train #travel is trending in #Europe. Here is the roundup of latest news on the development of railways, routes, and ticketing systems.https://klaava.com/european-railway-news-summary-unified-train-systems-off-the-beaten-rail-tips-mr-bean-restaurant/


Wine, women, and song. #dance #festival

2025-08-14 17:47:25

arihak

Wine, women, and song.#dance#festival


Secure parking in shade

2025-08-09 14:12:42

Secure parking in shade


News

2025-08-08 15:52:00

Other key findings in the study were that professional criminal groups are taking over business from independent amateurs, and scammers are making extra revenue by grabbing tourists’ personal data as well. #travel #scamhttps://klaava.com/vacation-apartment-scammers-grab-your-money-and-as-a-bonus-may-steal-your-identity-as-well/


News

2025-08-06 09:05:00

A new bucket list #travel destination?Chongqing’s architecture style is unique. The concrete and mountain terrain, with lots of industrial design, make it seem like a futuristic movie set, but at night, lights elevate the city into a true #cyberpunk dream.https://edition.cnn.com/travel/chongqing-china-tourism-cyberpunk-city-intl-hnk


News

2025-07-31 14:20:00

Perhaps not a bicycle for the Tour de France, but takes the rider up a steep hill to home.#streetphotographyflic.kr/p/2rjRBQvhttps://flic.kr/p/2rjRBQv


The nicest tourist information office I have seen so far.

2025-07-30 17:20:05

arihak

The nicest tourist information office I have seen so far.


News

2025-07-27 14:02:00

My first impression during a recent visit was that Innsbruck felt like a large and busy city, but pretty soon I realized that it is really quite compact. #Europe #travelhttps://klaava.com/innsbruck-may-be-renowned-for-winter-sports-but-it-really-is-a-pretty-historical-city/


News

2025-07-19 20:27:00

Star trek? No, feet on the ground in Valencia#streetphotographyhttps://www.flickr.com/photos/arihak/54479762808/in/photostream/lightbox/


News

2025-07-10 13:26:00

Behavior rules are being documented as town-specific or national-level regulation in European countries, especially in the south where sun seeking tourists may forget that the town belongs to local people who simply want to live in their home town. #travel #Europehttps://klaava.com/nitpickers-travel-journal-behave-or-else-unwritten-cultural-rules-in-europe/


But there are three fortresses on the other side of border.

2025-07-08 16:06:04

But there are three fortresses on the other side of border.


Border town safety net.

2025-07-07 18:24:59

arihak

Border town safety net.


News

2025-07-07 16:16:00

Instead of fumbling with plastic chips, you download a mobile profile directly onto the secure micro-chip already soldered inside most recent phones (think iPhone XR and newer, Google Pixel 3+, Samsung Galaxy S20 series and up). #phone #travelhttps://klaava.com/esim-the-tiny-tech-that-makes-big-adventures-stress-free/


News

2025-07-01 16:15:00

Canyon road is a magnet for cyclists and motorists.#photography #travelphotography #europeflic.kr/p/2rdW4Mfhttps://flic.kr/p/2rdW4Mf


The historic center of Krakow in Poland features castles, churches, palaces ... and tourists.

2025-06-23 13:31:04

The historic center of Krakow in Poland features castles, churches, palaces ... and tourists.


A man with his donkey.

2025-06-19 15:54:21

arihak

A man with his donkey.


News

2025-06-19 15:11:00

An eye-catching place for a painting.#streetphotographyhttps://wordpress.org/photos/photo/9536554ee4/