---
title: "How to put an HTML file online and share it as a link"
description: "Publish one HTML file or a folder at name.cool.computer with one command, free and with no card, then share the link or keep it private."
canonical: "https://www.cool.computer/blog/host-html-file-free"
last_updated: "2026-11-17"
---
# How to put an HTML file online and share it as a link

> Publish one HTML file or a folder at name.cool.computer with one command, free and with no card, then share the link or keep it private.

To put an HTML file online, install the `cool` CLI and run `cool publish page.html --name my-page`. The file is served at `https://my-page.cool.computer` at once, and you can send that link to anyone. It is free, needs no card, and works for one file or a whole folder.

There is no server to set up and no build step. No computer runs behind the page. Publishing again makes a new release at the same address, so the link stays the same.

## Steps

1. Install `cool`. On macOS or Linux:

   ```sh
   curl -fsSL https://cool.computer/install.sh | sh
   ```

   On Windows, in PowerShell:

   ```powershell
   irm https://cool.computer/install.ps1 | iex
   ```

   With Homebrew: `brew install the-money-company-limited/tap/cool`.

2. Publish the file:

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

   One HTML file is published as the site's `index.html`. Pick a name of 1 to 56 lowercase letters and digits, with single hyphens between words, such as `bakery-menu`.

3. Copy the URL it prints, for example `https://my-page.cool.computer`, and share it. Without an account the site is public, and the output includes a claim link. Open it and sign in within 24 hours to keep the site; otherwise it is deleted. Signing in in the browser does not sign in the CLI, so run `cool login --email you@example.com` before you share or update the site from the terminal.

4. To keep the page private instead, sign up first with `cool signup --email you@example.com`, which emails you a six-digit code to finish sign-up. Then publish with `--visibility private` and share it by email:

   ```sh
   cool publish page.html --name my-page --visibility private
   cool share add my-page ana@example.com
   ```

   A private site opens only for you and the people you add, after they sign in with the invited address.

5. To change the page, edit the file and publish to the same site:

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

### A folder instead of one file

Point `cool publish` at a directory to publish everything in it, with `index.html` at its root:

```sh
cool publish ./site --name my-page
```

Publishing never runs a build. For a framework app, build it first (for example `npm run build`) and publish the output folder, such as `./dist`. When you update a folder, only the changed files are uploaded. If the app routes in the browser, add a `cool.json` at the root with `{"spa": true}` so every path that is not a file serves `index.html`.

### Without installing anything

The same publish works over HTTP. This sends `page.html` with no account:

```sh
curl -sS "https://api.cool.computer/api/publish?name=my-page" \
  -H 'content-type: text/html' --data-binary "@page.html"
```

The JSON answer holds the site's `url` and its `claim_url`. The claim link is shown only once, so keep it.

### From a chat app or an agent

If the HTML came from an agent, it can publish the page for you. Paste the prompt from [/setup](/setup) into Claude Code, Codex or Cursor. In a chat app such as Claude or ChatGPT, connect Cool Computers from its connector directory, or add `https://api.cool.computer/mcp` by hand, and ask it to put the page on cool.computer.

## Why and when to use it

Use it when you have an HTML file and want a link, not a hosting project:

- One command, no repository: The file goes online as it is. No Git, no build settings.
- A link that lasts: Each publish is a new release at the same address. If one goes wrong, `cool releases my-page` lists them and `cool releases promote my-page 2` makes release 2 live again.
- Private when you need it: Share by email instead of hoping nobody finds the URL.
- Feedback on the page: People who can open the site can pin comments to any element and draw on it.
- More than static files, still free: A `cool.json` can add an API under `/api` that runs at the edge, a small database and secrets for the keys it needs.

It is not the right tool for everything. A program that has to keep running, such as a server, a bot or a scheduled job, needs a VM, and VMs need Pro.

## How it compares

Git-based static hosting is a good fit for a project that already lives in a repository and has a build pipeline. For a single file, it means creating a repository and a project first.

File-sharing and cloud-storage links share the file itself. Depending on the service, the person may download it or see the source instead of a working page.

Code playgrounds and pastebins are made for showing and editing code. They are useful for a snippet, less so for a page you want people to use at its own address.

Cool Computers sits between these: one command, a real address, and sharing and comments built in.

## Questions

### Is it really free to host an HTML file?

Yes. Free costs nothing and needs no card, for as long as you want. It holds up to 20 sites at once, and an account's sites share 5 GiB of published content. Pro, USD 20 a month, lifts the limit on sites and adds VMs. See [pricing](/pricing).

### Can I share an HTML file as a link without an account?

Yes. Run `cool publish page.html --name my-page` without signing in. The site is public and you get a claim link. Sign in within 24 hours to keep it, or the site is deleted.

### Does the page work with CSS, JavaScript and images?

Yes. Put them in a folder with `index.html` and publish the folder. The page runs in the visitor's browser like on any website.

### How do I update the page without changing the link?

Publish to the same site with `--computer`: `cool publish page.html --computer my-page`. The address stays the same, and each publish becomes a new release.

### Can I use my own domain?

Yes. `cool domain set my-page app.example.com` prints the two DNS records to create at your DNS provider. Page comments show on the `cool.computer` address, not on custom domains yet.

### How do I take it down?

Delete the site with `cool delete my-page`. That removes it from your account with its files and inbox.

No terminal? Paste the page into [HTML to link](/html-to-link). Coming from drag and drop? See [a Netlify Drop alternative](/blog/netlify-drop-alternative). Weighing options? See [11 ways to share an HTML file as a link](/blog/best-ways-to-share-html-file-as-link). More on what you can build: [how it works](/how-it-works), the [CLI install page](/install), and sites other people made on [/explore](/explore).
