Deploy MkDocs in seconds
MkDocs is a Python generator, so Tuqo does not build it on the server. Build the documentation locally with mkdocs build and upload the site/ folder. Tuqo serves the static files over HTTPS with free SSL.
site · free SSL Build locally
mkdocs build, and MkDocs generates the static site in site/.
Pack the output
tar -czf site.tar.gz -C site . puts index.html at the root of the archive. A .zip works too, and in the panel you can simply drag the folder in.
Upload to Tuqo
The site is on name.tuqo.ru right away, free SSL, a custom domain from the Start plan.
# build MkDocs locally (Python, not Node: Tuqo builds npm projects only)
mkdocs build
# pack the finished output (index.html must be at the root of the archive)
tar -czf site.tar.gz -C site .
# deploy over REST (or from the panel, or from an AI agent over MCP)
SITE=<site_id> # from the panel or list_sites
curl -X POST https://api.tuqo.ru/api/v1/sites/$SITE/deploys \
-H "Authorization: Bearer tqk_xxx_yyy" \
-H "Content-Type: application/gzip" \
--data-binary @site.tar.gz
The command line is not the only way: in the panel you can simply drag the site folder
in, and instead of .tar.gz a
.zip works too — Tuqo detects the archive
format by itself.
Deploying MkDocs — frequently asked questions
Why is MkDocs not built on the server? +
Tuqo builds only Node projects (npm). MkDocs is written in Python, so build locally and upload the ready site/ folder.
Is the Material theme supported? +
Yes. Material for MkDocs produces ordinary static files in site/, published the same way.
What exactly do I upload? +
The contents of site/ (index.html and assets): drag the folder into the panel or pack it into a .tar.gz or .zip.