Skip to content

Self-Host Your Own Instance

This page is the short routing point for self-hosting. The current setup and deployment instructions live under the html2rss-web docs so the Docker, token, and Browserless guidance only exists in one place.

  1. Run html2rss-web locally to verify your own instance with an included feed first.
  2. Deploy html2rss-web to production when you are ready to expose or operate it.
  3. Use automatic feed generation only if you want the token-gated page-URL workflow.
  • html2rss-web is the recommended self-hosted product surface.
  • Included feeds are the lowest-maintenance way to prove a deployment.
  • Automatic feed generation is disabled by default in production.
  • The generated API contract is published as OpenAPI at /openapi.yaml.
  • Custom config work belongs in the core html2rss docs and JSON Schema.

Running a reliable deployment benefits the broader community. Share your server with the broader community by adding it to the community instance list once it is stable and you are ready for other readers. Include details such as uptime expectations, moderation policy, and contact information so people know what to expect.

Thanks for investing the time to share html2rss with others. Each new instance expands the open web and helps readers stay in control of the stories they follow.