Deploy Isso

Self-hosted Disqus alternative: lightweight comment server for your site

Deploy Isso

/db

Deploy and Host Isso on Railway

Isso is a lightweight, open-source commenting server written in Python, a self-hosted alternative to Disqus. Readers can post, edit, reply to and vote on comments under your pages without an account, and you add the comment section to any static site or blog with one script tag. Comments are stored in a SQLite database.

About Hosting Isso

This template runs Isso 0.14.0 as one service built from a public GitHub repo that pins the official image by version and digest. The SQLite database sits on a Railway volume at /db, so comments survive restarts and redeploys. The admin password and the hash salt are generated for you, and Isso's public URL is set from the Railway domain. After deploying, set ISSO_HOST to your website's URL (for example https://blog.example.com) so Isso accepts comments from it, then add the embed snippet to your pages. Moderation, email notifications and other options are plain environment variables.

Common Use Cases

  • Add comments to a static site or blog (Hugo, Jekyll, Eleventy, Astro) without a third-party service
  • Replace Disqus to keep readers' comments and data on your own server, with no ads or tracking
  • Run a moderated comment section where new comments wait for approval in the admin page

Dependencies for Isso Hosting

  • The isso service, built from aalfath/isso-railway-template (official ghcr.io/isso-comments/isso:0.14.0 image)
  • A Railway volume at /db for the SQLite database

Deployment Dependencies

Implementation Details

After deploying, set ISSO_HOST to the site(s) that will show comments (comma-separated). Then embed Isso in your pages: add a script tag with src="https://YOUR-ISSO-DOMAIN/js/embed.min.js" and data-isso="https://YOUR-ISSO-DOMAIN/", plus a section element with id="isso-thread" where the comments should appear. The repo README has the copy-paste snippet.

Until ISSO_HOST is set, only Isso's own demo page at /demo/ can post comments. The moderation page is at /admin/, and its password is ISSO_ADMIN_PASSWORD in the service's Variables tab. Set ISSO_MODERATION=true to hold new comments for approval. For email notifications, add ISSO_SMTP_HOST, ISSO_SMTP_PORT, ISSO_SMTP_USERNAME, ISSO_SMTP_PASSWORD, ISSO_SMTP_FROM and ISSO_SMTP_TO. The other supported options are listed in the repo README. The template passes each visitor's real address (from Railway's edge) to Isso, so its per-IP spam guard and vote checks work behind Railway's proxy.

Why Deploy Isso 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 Isso 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.


Template Content

More templates in this category

View Template
Pixelfed
Explore + Share beautiful photos and videos on the Fediverse

Evan Boehs
30
View Template
Hexo
Hexo — fast static blog framework with admin editor and S3 media storage

INAPP
2
View Template
Castopod
Self-hosted podcast hosting with Fediverse support

INAPP
1