Upgrading your site to the latest version of TiddlyWiki

Overview

There's no built-in "upgrade site" functionality in Tiddlyhost, so you need to do the following:

• Download your site to a local file
• Upgrade the local file using the TiddlyWiki Upgrade Wizard, just like you would for any other TiddlyWiki file, then
• Upload it back to Tiddlyhost

The following instructions will walk you through that process in more detail.

Note: This upgrade method is likely to convert your "external core" TiddlyWiki to a regular internal core TiddlyWiki. See this alternative upgrade method for a way to avoid that. Or, you can use this upgrade method and then convert your site back to external core using this conversion method.

Detailed step-by-step instructions

1. Download your site

• Make sure you're logged in to Tiddlyhost then click "Home" to view your sites list
• Find the site you want to upgrade, click its "..." actions menu and then click "Download"
• Identify where the downloaded file was saved. Usually it's in your "Downloads" directory but it depends on your browser

2. Upgrade the downloaded TiddlyWiki file

• Visit the TiddlyWiki Upgrade Wizard at tiddlywiki.com/upgrade.html
• Click the big button to upload your TiddlyWiki
• Find the TiddlyWiki file you just downloaded and select it
• Review the list of tiddlers being imported. (I think it's generally safe to leave the default selections as they are)
• Click the "Upgrade" button
• Click the green "Save upgraded TiddlyWiki button" which should cause a new file to be downloaded called "upgrade.html"
• Identify where that file was saved. Once again it's usually the "Downloads" directory

3. Verify the upgrade

• Open the newly downloaded "upgrade.html" file and make sure it works as expected. It's likely to work fine, but there might be plugin or other compatibility problems, so it's worthwhile checking

4. Upload the new TiddlyWiki file to your Tiddlyhost site

• Back on the sites list, find the site you're upgrading, click the "..." actions menu and select "Upload". Tip: Be extra careful to choose the correct site
• Click the "Choose file to upload" button and select the new "upgrade.html" that you verified in the previous step
• Click the "Upload file" button and click "Ok" to confirm

5. Confirm the upload was successful and that everything is working

• View your newly upgraded site online at its usual Tiddlyhost url. Make sure you hit reload to ensure you have the latest freshly updated version
• Optionally you can verify the TiddlyWiki version by putting <<version>> inside a tiddler's content and seeing what it says
• Click the save button and confirm that the site saves as per usual
• (In the unlikely event that something is broken at this point, you can restore the previous version of your site by redoing the upload step and selecting the originally downloaded TiddlyWiki file instead of the upgraded file)