Repolode
Submit
rafalp

rafalp/Misago

A modern, self-hosted Python/Django forum application with React-based frontend, moderation tools, polls, private threads and OAuth sign-in.

Open-source alternative to:phpBBvBulletin

View on GitHubWebsite
Stars
2,779
Forks
557
Open issues
174
Last commit
2 days ago

What is it?

Misago is a forum application built with Python and Django. It covers the features typically expected of a public internet forum: user registration with email activation or admin approval, avatars, profile editing, password reset, and sign-in through OAuth providers such as Facebook, Google and GitHub.

For site operators, Misago provides nested categories with unlimited depth, a permission system based on ranks, roles and categories, a moderation toolset with approval queues, a ban system, and a post edit log with revert. Members can post in GitHub-flavoured markdown or a BBCode subset, create private threads, run polls, and mark a best answer in question threads.

The frontend uses React components backed by a Django JSON API, and the admin panel is separate. Development runs in Docker via a `dev` helper script. The project describes itself as still in an early, rapidly changing stage.

Key features

  • 01Nested categories with unlimited depth and fine-grained permissions
  • 02Moderation tools, approval queues and an edit log with revert
  • 03Polls, private threads and best-answer marking
  • 04Sign-in via 50+ OAuth providers and a JSON API for integration
  • 05Markdown and BBCode post formatting

Use cases

  • Running a community or support forum with moderation workflows
  • Building a members-only discussion space with private threads
  • Adding a forum with single sign-on to an existing website

Quick start

  1. 1

    Clone the repository from GitHub

  2. 2

    Run the dev init command (requires Docker)

    ./dev init
  3. 3

    Start the development server

    docker compose up
  4. 4

    Open http://127.0.0.1:8000/ in your browser

Things to know

  • The README describes development status as perpetual beta ("Bananas"), so expect rough edges.
  • Licensed under GPL-2.0, a copyleft license that requires derivative works to remain open source.
  • The recommended development setup depends on Docker.
  • On Windows, git line-ending conversion can break the ./dev script unless auto-conversion is disabled before cloning.

In collections

Self-hosted apps

Topics

#forum#django#python#community#self-hosted#htmx#docker#forums

FAQ

What is Misago?
A modern, self-hosted Python/Django forum application with React-based frontend, moderation tools, polls, private threads and OAuth sign-in. Misago is a forum application built with Python and Django. It covers the features typically expected of a public internet forum: user registration with email activation or admin approval, avatars, profile editing, password reset, and sign-in through OAuth providers such as Facebook, Google and GitHub.
Is Misago free to use? What license does it have?
Misago is open source under the GPL-2.0 license. Check the license terms before using it in commercial products.
Is Misago still maintained?
Actively maintained. The last commit to Misago was on Nov 5, 2026.
What can I use Misago for?
Running a community or support forum with moderation workflows Building a members-only discussion space with private threads Adding a forum with single sign-on to an existing website
How do I install Misago?
Clone the repository from GitHub Run the dev init command (requires Docker): ./dev init Start the development server: docker compose up Open http://127.0.0.1:8000/ in your browser
Where can I get Misago?
The source code and installation instructions are on GitHub: https://github.com/rafalp/Misago

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects