Getting Started

Pubby publishes a web page in under 3 seconds. There's not much to learn. This doc covers the three ways to publish, how authentication works, and what you get after a successful publish.

If you've used any hosting tool before, this will feel faster than you expect.

Three ways to publish

You can publish via the web UI (point-and-click), the API (programmatic, for scripts and agents), or the CLI (terminal-native, no browser required). All three produce the same result: a live URL with SSL.

Pick whichever fits how you work. Most people start with the web UI, then move to the API once they want to automate.

Web UI

The simplest path. Open pubby.au, paste your HTML into the editor or drag a file onto the upload target, and click Publish. The URL appears within 3 seconds. No account required for your first publish on the free plan.

API

The Pubby API is one endpoint. You POST a file (or raw HTML), and you get a JSON response containing your live URL. No setup beyond getting an API key.

curl -X POST https://api.pubby.au/v1/publish \
  -H "Authorization: Bearer pk_live_your_api_key_here" \
  -H "Content-Type: multipart/form-data" \
  -F "file=@./index.html" \
  -F "slug=my-page" \
  -F "expires=never"

{
  "success": true,
  "url": "https://my-page.pubby.au",
  "slug": "my-page",
  "expires": null,
  "ssl": true,
  "published_at": "2026-02-22T12:34:56Z"
}

curl -X POST https://api.pubby.au/v1/publish \
  -H "Authorization: Bearer pk_live_your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{
    "html": "<h1>Hello</h1><p>This is a test page.</p>",
    "slug": "hello-world",
    "expires": "7d"
  }'

CLI

The Pubby CLI wraps the API in a terminal command. Install it once, configure your API key, and publish from wherever your files are without opening a browser.

npm install -g pubby-cli

pubby auth login

# Publish a single file
pubby publish ./index.html

# Publish a directory
pubby publish ./my-site/

# Publish with a custom slug
pubby publish ./report.html --slug q4-report

# Publish with expiry
pubby publish ./demo.html --expires 7d

What happens after you publish

Next steps