---
title: "Deploy Isso"
description: "Self-hosted Disqus alternative: lightweight comment server for your site"
category: "Blogs"
url: https://railway.com/deploy/isso-1
---

# Deploy Isso

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

**[Deploy Isso on Railway](https://railway.com/template/isso-1)**

Machine-readable deploy manifest (JSON, validated by TemplateCI): https://railway.com/deploy/isso-1/manifest.json

- **Creator:** Agaz Self-Host
- **Category:** Blogs

## Template content

### isso https://cdn.jsdelivr.net/gh/isso-comments/isso@0.14.0/isso/img/isso.svg

- **Source:** https://github.com/aalfath/isso-railway-template
- **Health check:** /info
- **Public domain:** Yes

## Documentation

# 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

* [Isso documentation](https://isso-comments.de/docs/)
* [Isso server configuration](https://isso-comments.de/docs/reference/server-config/)
* [Isso 0.14.0 release](https://github.com/isso-comments/isso/releases/tag/0.14.0)
* [Template repository](https://github.com/aalfath/isso-railway-template)

### 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.



## Similar templates

- [Pixelfed](https://railway.com/deploy/OZSdEw) — Explore + Share beautiful photos and videos on the Fediverse
- [Hexo](https://railway.com/deploy/hexo) — Hexo — fast static blog framework with admin editor and S3 media storage
- [Castopod](https://railway.com/deploy/castopod-clone) — Self-hosted podcast hosting with Fediverse support

Open this page in a browser: https://railway.com/deploy/isso-1
