Archiving to GitHub

Micro.blog can automatically copy your posts to a GitHub repository. It uses a similar structure to the Blog Archive Format: an HTML file and JSON Feed of all your blog posts, and an “uploads” folder with all of your photos. Micro.blog will update the archive on GitHub approximately once a week. (If you need an immediate backup, use the Posts → Export feature.)

To enable GitHub archiving, click on Posts → Design and enter a GitHub repository name. Only include the repository name, not a full URL. When you save your blog settings, Micro.blog will prompt you to sign in to your GitHub account.

The repository must be public and must be on the same GitHub account you are signed in as, not a separate GitHub organization. Micro.blog will not have access to any private repositories. Make sure the GitHub repository is not empty. (If it’s a new repository, you can initialize the repository with a README from GitHub.)

To disable archiving and sign out of GitHub, clear the repository name and save your blog settings again from the Posts → Design tab.

Micro.blog does not attempt to remove files from your GitHub repository. If you delete an upload from your blog, you’ll need to also delete it manually from GitHub.

If you want GitHub Pages to serve your archive over the web, use a repository name in the format your-username.github.io.

2 Likes

I have had trouble getting this to work. For clarification, do I include the username in the text field?

Ideally it would be great to see some sort of history of how recently the archive process ran, and whether it succeeded.

2 Likes

Never mind, I spoke too soon!

Apparently it starred working 15 days ago and I didn’t notice. I’m not sure what changed but I’m glad it’s working!

1 Like

One more thing. The help link above the text field is broken at the moment.

(not urgent) You only get one your-username.github.io personal site. Is it not possible to enable GitHub Pages on a repo with another name?

Will leave it if not.
To be fair, WayBack Machine seems to have great coverage (by multiple different crawlers, even before I ticked the box (I think for the first time but maybe not) in April 2021:

How long does it take to populate generally?

And just for clarification when we say the repository name is it intended to be exclusively the name of the repo or <userName>/repo my guess is the former but I just wanted to clarify.