Diskus Logo Diskus
GitHub

Navigation

Introduction Architecture Quick Start Deployment Configuration Usage Dashboard Guide Security API Reference

Welcome to Diskus

License: GPL v3 Bun Preact

Diskus is a lightweight, self-hosted comments system built for modern web applications. Designed to be a blazing-fast, privacy-respecting alternative to bloated third-party commenting services (like Disqus), it puts you fully back in control of your users’ data and your website’s performance.

Why Diskus?

In the modern web ecosystem, adding a comment section often means sacrificing performance or user privacy. Traditional embeddable comment platforms inject massive JavaScript bundles, tracking cookies, and heavy iframes that ruin your Core Web Vitals.

Diskus was built from the ground up to solve this problem by providing a modern, developer-friendly alternative:

  • Zero Tracking: You host the data. There are no invisible trackers, no ad networks, and no selling of user data.
  • Lightning Fast: The entire widget payload is radically optimized.
  • Developer First: Built with Bun, Hono, and Preact, offering an incredibly fast development loop and type-safe backend.

Core Features

  • Ultra-lightweight Footprint: The initial embed script is a mere ~2KB, and the total widget size is ~22KB (gzipped). It has virtually zero impact on your page load speeds.
  • 100% CSS Isolation: Instead of using heavy <iframe> tags, Diskus injects the comment widget directly into a native Shadow DOM. This guarantees that your website’s CSS never conflicts with the widget’s design, and vice-versa.
  • Multi-tenant Architecture: You only need to deploy Diskus once. From a single centralized dashboard, you can manage comments across multiple domains, blogs, and websites seamlessly.
  • Built-in Anti-Spam: Say goodbye to annoying CAPTCHAs. Diskus utilizes native backend rate-limiting and invisible frontend honeypot traps to silently catch and reject automated bot registrations.
  • Server-side Sanitization: Client bundles stay small because strict HTML sanitization (isomorphic-dompurify) and Markdown parsing are completely offloaded to the server.
  • Data Portability: Your data is yours. Diskus provides full JSON-based import and export capabilities for threads and comments.
  • Email Notifications: Configurable email alerts for new comments powered by Resend API integration, keeping you in the loop when discussions happen.