---
title: "A GitHub Pages alternative for one HTML file"
description: "GitHub Pages needs a repository and makes the page public. For one HTML file, cool publish gives you a link in one command, private if you want."
canonical: "https://www.cool.computer/blog/github-pages-alternative-single-html-file"
last_updated: "2026-11-20"
---
# A GitHub Pages alternative for one HTML file

> GitHub Pages needs a repository and makes the page public. For one HTML file, cool publish gives you a link in one command, private if you want.

GitHub Pages is a good free host for a site that lives in a Git repository. For a single HTML file it asks for a lot: create a repository, push the file, turn on Pages, and accept that the page is public. If you only want a link to one file, run `cool publish page.html --name my-page` and it is live at `https://my-page.cool.computer`. It is free, needs no repository, and the page can be private.

## The steps

1. Install `cool`:

   ```sh
   curl -fsSL https://cool.computer/install.sh | sh
   export PATH="$HOME/.local/bin:$PATH"
   ```

2. Publish the file:

   ```sh
   cool publish page.html --name my-page
   ```

3. Share the URL it prints. Without an account the site is public and you get a claim link; sign in within 24 hours to keep it.

To update the page later, publish to the same site with `cool publish page.html --computer my-page`. The address stays the same.

## What is different from GitHub Pages

- No repository: the file goes online as it is. There is no commit, branch or Pages setting.
- Private pages on the free plan: publish with `--visibility private` and invite people with `cool share add my-page ana@example.com`. On GitHub Free the repository must be public, and a Pages site is public on the internet unless you are on Enterprise Cloud ([GitHub docs](https://docs.github.com/en/pages/getting-started-with-github-pages/github-pages-limits)).
- No account to start: publish first, sign in later to keep the site.
- Comments on the page: signed-in people who can open the site pin comments and drawings to it.
- An agent can do it: Claude Code, Codex and Cursor run the same command.

## When GitHub Pages is the better choice

- The site is a project with history, pull requests and contributors.
- You want documentation published from the same repository as the code.
- You need a large public site: GitHub Pages allows up to 1 GB and about 100 GB of bandwidth a month.
- You already build it with GitHub Actions.

Cool Computers' free plan holds 20 sites that share 5 GiB. For a big public site kept in Git, GitHub Pages or Cloudflare Pages is a better fit.

## Questions

### Can I host one HTML file on GitHub Pages?

Yes, but through a repository: create one, add the file as `index.html`, push, and enable Pages in the repository settings. The site is public.

### Can a GitHub Pages site be private?

Not on GitHub Free. Private Pages sites need GitHub Enterprise Cloud. To share an HTML page with only a few people for free, publish it private on Cool Computers and invite them by email.

### Is there a GitHub Pages alternative with no Git?

Yes. `cool publish` uploads a file or a folder directly. Drop pages from Vercel, Netlify and Cloudflare also need no Git; see [how they compare](/blog/vercel-drop-vs-netlify-drop-vs-cloudflare-drop).

### Can I use my own domain?

Yes. `cool domain set my-page app.example.com` prints the two DNS records to add.

### Does it run JavaScript and load CSS and images?

Yes. Put them in a folder with `index.html` and publish the folder: `cool publish ./site --name my-page`.

More detail on publishing one file is in [how to put an HTML file online](/blog/host-html-file-free), and more options are in [11 ways to share an HTML file as a link](/blog/best-ways-to-share-html-file-as-link).
