html-golive — self-hosted one-command HTML deployment

Why it exists

You have an HTML file — a report, a dashboard, an internal tool — and you need it on a URL your colleagues can open. The usual answers are a cloud platform that can't touch your data, or a bare nginx that gives you nothing but a file server. html-golive is the middle ground: run it yourself, keep everything inside your network, and still get the conveniences you expect.

🔒

Your data stays put

Runs entirely on your own machine or server. No account, no telemetry, no outbound calls by default — works airgapped.

🪶

Zero dependencies to start

The core install is standard-library only. Local filesystem plus SQLite; no database or object store to provision.

📈

Grows with you

Swap in Supabase or any S3-compatible store (MinIO, COS, OSS, TOS) with one yaml file. Same commands, bigger backend.

What you get

Everything below ships in the box — one install, no plugins to hunt down.

🚀

Publish & roll back

Every publish snapshots the previous version. golive rollback returns to any of them instantly.

✏️

Edit in the browser

Owners and maintainers get an inline editor on the live page — fix a typo without touching the source file. Saves are scanned and snapshotted.

🗄️

A database for static pages

window.TemplateAPI and window.SupabaseAPI are injected into your page, so plain HTML can read and write real rows.

🛡️

Secrets scanning

Rule-based detection of API keys, tokens and personal data before anything goes live — with optional LLM second-pass review.

🎨

19 built-in styles

Turn an unstyled document into something presentable with --style. Fonts come from public CDNs or your own mirror.

🧑‍💼

Admin console

A self-contained web portal at /admin: all sites, ownership transfer, maintainers, rollback, stats and an audit trail.

🔑

Real authentication

Static token for quick setups, or OIDC with one-line presets for Google, Auth0, Okta, Azure AD, Keycloak and Authentik.

🕸️

Clone any page

golive clone <url> snapshots a public page, inlines its assets and republishes it as your own.

🐳

Docker ready

A Dockerfile and a compose file with an optional MinIO profile — from zero to a running server in one command.

Quickstart

Three steps, about a minute. No configuration file needed to begin.

Install

Python 3.9 or newer. Optional extras add image compression and S3 support.

$ pip install html-golive

Publish a page

Point it at any HTML file. It scans for secrets, applies a style, bundles assets and registers the site.

$ golive publish report.html --style minimal

Serve it

Binds to localhost by default. Add --host 0.0.0.0 when you're ready to share — pair it with a token or OIDC.

$ golive serve 🚀 http://localhost:8787/ · admin portal: /admin

Architecture

Three pluggable interfaces. Start on the left column, move to the right when you outgrow it — your commands and your pages don't change.

Storage

local filesystem (default)
supabase storage bucket
s3 MinIO / COS / OSS / TOS

Registry

sqlite single file (default)
supabase Postgres table

Data

none static pages only
postgrest Supabase / any PostgREST

Identity

none loopback-only access
token shared bearer token
oidc Google, Okta, Keycloak…

Command reference

Thirteen commands cover the whole lifecycle. Full detail lives in the user manual.

Command	What it does
`publish`	Scan, style, bundle and deploy an HTML file
`list`	Show every registered site with size and owner
`rollback`	Restore a previous snapshot
`serve`	Run the HTTP server and the admin portal
`preview`	Serve a local file without registering it
`clone`	Snapshot a public page and republish it
`maintainer`	Grant or revoke edit rights on a site
`admin`	Open the admin console
`styles`	List the 19 built-in visual styles
`data` / `db`	Inspect and manage the data backend
`migrate-check`	Find environment-specific references in an HTML file
`doctor`	Diagnose configuration and connectivity

Ship an HTML file.
Get a real website.