migration
This article is a stub. You can help the IndieWeb wiki by expanding it.
migration in the context of the indieweb refers to the process of moving your indieweb site from any one or more of one CMS / web host / DNS provider / URL design / domain name to another.
Related specific aspects of migration
How to
How to migrate webhost
- Reduce TTLs to minimum. If youβre even considering migrating your site(s) from one webhost to another, the very first thing to do is
- Make a list of the domains youβre considering moving
- Login to your domain name provider and reduce the TTL to the lowest value allowed
- See: TTL#How_to_configure for more details on reducing TTL.
- Confirm an email independent of domains being migrated. Make sure you have an email address that is independent of any domains you are migrating, so you can use that as your contact info while migrating.
- Pick a new webhost and create an account with them (using that email address).
- Export your data. At your old webhost, find the export feature to download your data to your computer. This is also a good backup to have if anything goes wrong. WordPress, Micro.blog, Tumblr, and other blog platforms all have an export feature. Make sure to keep your old web site up during the migration because some import tools may need to access it, for example for downloading images that aren't included in the export.
- Import your data to the new webhost after creating your account or creating the new blog.
- Update your DNS settings so that your domain name is now pointed to the new webhost.
Previewing your site at the new host
If you'd like to preview your site at the new host, before switching DNS or before your DNS changes have propagated, you can "trick" your computer into thinking that your domain has moved by editing your hosts file.
First you'll need to know the IP address of your new host. You can ask your new DNS servers this if you don't know it some other way:
dig +short a example.com @ns1.dreamhost.com
- Replace example.com with the domain you are moving
- Enter your new host's nameservers in place of ns1.dreamhost.com
You should see the IP address returned on the command line. If you don't get back an answer, then something isn't ready at the new web host.
Then you'll need to edit your hosts file (/etc/hosts
). This will usually have to be done by the root user on your computer. Add a line to your hosts file with the new IP address and the domain name.
75.119.207.166 example.com
Now when you visit your domain it should be pulling from the new host. You may have to close all existing tabs, or restart your browser, in order for your browser to not return the old cached IP address.
If you aren't sure whether you're looking at the new host, you can make some change on the new server and see if it's reflected. For example adding a new file to your server, or changing some text on your home page.
IndieWeb Examples
IndieWeb examples of folks moving their primary personal site from one hosting setup to another.
Tantek
During IndieWebCamp Austin 2019, I migrated my site from my former hosting provider (who had decided to exit the business with a 30-day notice!) to DreamHost, and was able to do so successfully during the course of the camp with some help from others there, and as a result, also got LetsEncrypt-based HTTPS setup on his sites.
Manton
Manton Reece migrated his personal blog manton.org and some other blogs from WordPress to Micro.blog hosting, using Micro.blog's import feature for WordPress. For his podcast, Manton blogged about writing a script to help migrate MP3 files.
Other Independent Examples
Examples of independent newsletters and other similar efforts migrating their hosting from services or platforms other services, self-hosting, etc.
Citation Needed
- 2023-01-13 Molly White: Migrating from Substack to self-hosted Ghost: the details
Emphasis added.β¦ quickly I realized that what I wanted was not a new platform, but rather no platform. Although most platforms do a better job of content moderation than Substack, I feared that I could find myself in the same position down the road if my new host made a similarly unconscionable decision. I'm also a little bit of a control freak, and more generally, I like having as few opportunities as possible for would-be enshittifiers to mess around with what I'm trying to do. So, self-hosting seemed the obvious route to take β¦
Organization Examples
DreamHost Community
DreamHost moved their community discussion platform from MyBB to Discourse, and migrated their previous user accounts and forum content as well. They migrated some URLs from the old platform to the new platform, but apparently did not migrate the section under "old forums".
- archive.org snapshot of old forum: http://web.archive.org/web/20150906074546/https://discussion.dreamhost.com/forum-5.html
- redirected to https://discussion.dreamhost.com/c/customer-discussion
- archive.org snapshot of a thread: https://discussion.dreamhost.com/thread-146508.html
Welcome! (or welcome back?) You may have noticed that things look a little different around here! DreamHost has recently migrated our forums to a new software platform.
If you had an account on the old system weβve copied that over for you, however you will need to reset your password before youβre able to login. Youβll only need to do this once! Click on the "Log In" button above and the link to "I forgot my password".
Brainstorming
Ideally people will create their IndieWeb sites and their data will live at the same URL forever and ever into eternity.
In reality, sometimes people do change domain names (e.g. because of problems with previously trendy short-domains like .io or .ly) as well as publishing platforms from time to time. We should do our best best we can do is have a plan to handle this gracefully.
Domain Changes
The first case is where the source site notifies the target site that it has moved from:
old-source.com/note/213
to it's new home at:
new-source.com/note213
seems like there could be 2 approaches to this... sites crawl their own comments detecting the health of domains, or sites send notifications to others sites to "update me"
IndieAuth
Many apps will use the IndieAuth URL as a unique identifier for your account. If you change your domain, this will appear as a new user to these apps. We need some way to tell the app that the user has changed their URL, and to be able to prove the user still controls both, so that the app can update the unique identifier.
URL Structure Changes
The next case is where a user adopts a new publishing platform that has drastically different URL structure such as
same-source.com/note/345
move to new URL structure
same-source.com/note/2014/03/f5e82
SSL Change
The next case is where a user adds an SSL certificate to their domain. This can now be seen as a different URL.
http://domain.com/
is now
https://domain.com/
Solutions
It seems that the right solution should be able to handle both migration cases. Some rough ideas outlined thus far inlcude:
- Using 301 Redirects
- Onus on the source to notify targets to recrawl / verify their posts
- Targets can run a refresh on their own content to update / verify
See Also
- web hosting
- DNS providers
- CMS
- URL design
- permalinks
- http://www.kiaikim.com/2017/how-to-move-a-wordpress-site-from-one-webhost-to
- data-portability
- account migration
- multi-site indieweb
- post migration
- All kinds of migration challenges, and Mastodon's current features & limitations: 2023-07-26 Notes from a Mastodon migration