Tutorial — MkDocs

Deploy MkDocs
in seconds.

No CI/CD. No Git pushes. No deployment experience required. Go from a MkDocs project on your machine to a live website with one command.

Before you start

You'll need a MkDocs site on your machine. Don't have one yet? Follow the MkDocs getting started guide for your OS, then create a new site with the commands below.

terminal
# Install MkDocs
$pip install mkdocs
# Create a new MkDocs site
$mkdocs new my-docs
# Build the static site
$cd my-docs && mkdocs build
✓ Documentation built in 0.2 seconds
MkDocs generates your static site into a site/ directory. That's the folder Fyra deploys. Keep your terminal here — the next section picks up from inside ~/my-docs.
Deploy your MkDocs site

cd into your MkDocs site/ directory — that's the built site Fyra will deploy. No Git repos, no build pipelines, no dashboards.

~/my-docs/site
# Navigate to your MkDocs output directory
$cd ~/my-docs/site
# Step 1 — Install Fyra
$curl -fsSL https://fyra.sh/install.sh | sh
# Step 2 — Create an account (first time only)
$fyra register
Check your email to verify your account, then:
$fyra login
✓ Logged in
# Step 3 — Create your app
$fyra create
# Step 4 — Push it live
$fyra push
✓ Deployed to https://my-docs.apps.fyra.sh
$
Done. Your MkDocs site is live with SSL and CDN. Every time you make changes, just run fyra push again.
Why Fyra for MkDocs?

Most hosting platforms require you to connect a Git repo, configure build settings, and wait for a pipeline to run. Fyra skips all of that.

No Git flow needed

No commits, no pushes, no branches. Deploy straight from your local machine with fyra push.

Deploy in seconds

No build queues or CI minutes to burn through. Your files go live the moment you push.

Zero config

Fyra automatically detects your MkDocs site directory. No build commands, no config files.

SSL & CDN included

Every deployment gets HTTPS and a CDN out of the box. No extra setup required.

No deployment experience required

Never deployed a website before? Fyra was built for you. If you can run commands in a terminal, you can deploy MkDocs. No DevOps knowledge, no cloud accounts, no infrastructure to manage.

Custom domains

Use your own domain.

Want your MkDocs site on your own domain instead of a fyra.sh subdomain? Upgrade to the Trail plan and point any domain to your deployment.

Trail plan
$12/month
Custom domain mapping, CDN, SSL, and unlimited deploys included.