Deploy guide

How to deploy MkDocs

MkDocs builds your site to a folder of plain files. Here's how to build it, which folder to publish, and the setup on each host.

mkdocs buildsite

Pick a host

Where do you want it?

Fastest99helpersRun mkdocs build and drop the site folder. No git, no workflow file, no build settings: live in seconds, with passwords, analytics and AI editing built in.MkDocs on GitHub PagesFree hosting for static sites straight from a GitHub repository.

Before any host

Build it

Run mkdocs build. The site comes out in site: that folder is what goes online, whichever host you pick.

Good to know

Worth knowing first

  • If you use a theme or plugins, such as Material for MkDocs, put them in requirements.txt and change the install line in the workflow to pip install -r requirements.txt.
  • MkDocs also has mkdocs gh-deploy, which builds on your computer and pushes to a gh-pages branch. Then set Source to Deploy from a branch and pick gh-pages.

Or skip the setup

Drop it in. It's online in seconds.

A file, a folder or a whole site: 99helpers puts it online at its own address, with no git, no build settings and no DNS to start with. Add your own domain whenever you're ready.

Put it online freeWhere should I host it?