---
title: "Deploy html-hoster"
description: "Publish static HTML pages via REST API or AI agent."
category: "Other"
url: https://railway.com/deploy/html-hoster
---

# Deploy html-hoster

Publish static HTML pages via REST API or AI agent.

**[Deploy html-hoster on Railway](https://railway.com/template/html-hoster)**

- **Creator:** Antônio Miranda's Projects
- **Category:** Other
- **Total deploys:** 7

## Template content

### html-hoster https://raw.githubusercontent.com/codebyant/html-hoster/refs/heads/main/public/assets/logo.svg

- **Source:** codebyant/html-hoster
- **Health check:** /health
- **Public domain:** Yes

## Buckets

- **Bucket**

## Documentation

# Deploy and Host html-hoster on Railway

html-hoster is a lightweight REST API server that lets you publish static HTML pages programmatically. Send HTML via curl or an AI agent, get back a public URL — no CMS, no dashboard, no deploy pipeline needed.

## About Hosting html-hoster

html-hoster runs as a single Bun HTTP server exposing REST endpoints and a native MCP server for AI agent integration. This template deploys the full stack automatically: the Bun server is provisioned via the included `nixpacks.toml`, storage is pre-configured, and your public URL is set to the Railway-generated domain. The only thing you choose is your `API_KEY` — the secret token that protects all write operations. Once deployed, pages are served publicly at `/` with no authentication required.

## Common Use Cases

- **AI agent publishing** — connect Claude, Cursor, or any MCP-compatible agent to publish HTML reports, dashboards, or generated pages directly from a prompt
- **Programmatic landing pages** — deploy marketing pages or campaign content via API from CI/CD pipelines or backend services
- **HTML snippet hosting** — expose lightweight static content (changelogs, status pages, embeds) without managing a CMS or object storage CDN config

## Dependencies for html-hoster Hosting

- **Bun runtime** — provisioned automatically; no manual install needed
- **Local filesystem storage** — pages are stored on the Railway volume, pre-configured by the template

### Deployment Dependencies

- [Bun](https://bun.sh) — JavaScript/TypeScript runtime
- [mcp-remote](https://www.npmjs.com/package/mcp-remote) — bridge for connecting AI agents to the MCP endpoint (client-side only, not deployed)

### Implementation Details

After deploy, connect any MCP-compatible AI agent to your instance at `https://your-app.up.railway.app/mcp`:

```json
{
  "mcpServers": {
    "html-hoster": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://your-app.up.railway.app/mcp", "--header", "Authorization:${HTML_HOSTER_AUTH}"],
      "env": { "HTML_HOSTER_AUTH": "Bearer your-api-key" }
    }
  }
}
```

## Why Deploy html-hoster on Railway?

Railway is a singular platform to deploy your infrastructure stack. Railway will host your infrastructure so you don't have to deal with configuration, while allowing you to vertically and horizontally scale it.

By deploying html-hoster on Railway, you are one step closer to supporting a complete full-stack application with minimal burden. Host your servers, databases, AI agents, and more on Railway.

## Similar templates

- [Rocky Linux](https://railway.com/deploy/rocky-linux) — [Jul'26] Hosted Rocky Linux 9 workspace with SSH and persistent storage. 🚀
- [Foundry Virtual Tabletop](https://railway.com/deploy/X5tR6G) — A Self-Hosted & Modern Roleplaying Platform
- [Letta Code Remote](https://railway.com/deploy/letta-code-remote) — Run a Letta Code agent 24/7. No inbound ports, just deploy.

Open this page in a browser: https://railway.com/deploy/html-hoster