Misago logo

Misago

Modern, feature‑rich forum platform built with Django and React

Misago delivers a complete, customizable forum solution with robust moderation, OAuth login, GDPR tools, and a flexible permission system, all powered by Django and a React front‑end.

Misago banner

Overview

Overview

Misago is a full‑stack forum solution that combines a Django back‑end with a React front‑end. It offers essential community features such as user registration, avatar handling, private threads, polls, and best‑answer marking, while supporting both GitHub‑flavoured Markdown and BBCode.

Deployment & Extensibility

The project ships with Docker‑based development utilities (./dev init) that build containers, install dependencies, and run migrations, making local setup straightforward. Administrators can fine‑tune registration flows with email activation, reCAPTCHA, and IP blacklists, and leverage a granular permission system to control access per role or category. Misago also provides OAuth integration for over 50 providers, a JSON API for external integration, and a Bootstrap‑based theming layer. Future enhancements include a GraphQL API, plugin architecture, and a WYSIWYM editor, positioning Misago as a scalable choice for modern online communities.

Highlights

OAuth support for 50+ providers
Granular permission and role system
Rich moderation tools with queues and edit logs
Customizable themes and Bootstrap‑based UI

Pros

  • Extensive built‑in moderation features
  • Highly configurable user registration and spam protection
  • Modern React/Django stack ensures scalability
  • Docker‑based development simplifies setup

Considerations

  • No official test suite for frontend assets
  • Plugin system still under development
  • Documentation may lag behind rapid feature additions
  • Windows setup can encounter line‑ending issues

Managed products teams compare with

When teams consider Misago, these hosted platforms usually appear on the same shortlist.

Chanty logo

Chanty

Team chat and collaboration with channels, audio/video calls, and task management

Discord logo

Discord

Voice, video, and chat communities for groups and teams

Mattermost logo

Mattermost

Secure collaboration and messaging for mission-critical teams

Looking for a hosted option? These are the services engineering teams benchmark against before choosing open source.

Fit guide

Great for

  • Communities needing deep moderation and custom user roles
  • Projects that want OAuth login integration out of the box
  • Teams comfortable with Docker and Python/Django deployment
  • Sites requiring GDPR‑compliant forum features

Not ideal when

  • Small hobby forums that prefer lightweight solutions
  • Environments without Docker or Python expertise
  • Deployments requiring a mature plugin marketplace
  • Organizations needing a fully tested frontend build pipeline

How teams use it

Tech community with multi‑provider SSO

Members log in via Google, GitHub, or Steam, reducing friction and centralizing authentication.

Moderated Q&A site

Admins use edit logs, best‑answer marking, and moderation queues to maintain high‑quality content.

Corporate intranet forum with GDPR compliance

Custom data‑processing agreements and user‑data controls keep the forum aligned with privacy regulations.

Gaming guild forum with private threads

Players create invite‑only discussions for strategy planning while keeping the rest of the community public.

Tech snapshot

Python72%
JavaScript18%
HTML7%
Less3%
SCSS1%
Shell1%

Tags

forumhtmxpythonforumsdjangodocker

Frequently asked questions

What Python version is required?

Misago runs on Python 3.12.

How do I set up a development environment?

Clone the repo, run `./dev init` (or follow the Docker commands) to build containers, install dependencies, and start the server with `docker compose up`.

Can I integrate existing user accounts?

Misago provides an OAuth2 client and JSON API for integration with external authentication systems.

Is there support for custom themes?

Yes, the UI is built with Bootstrap and can be customized via the theme system and the `scripts.html` hook.

What are the known Windows installation issues?

Line‑ending conversion can break the `dev` script; disabling automatic CRLF conversion in Git resolves the problem.

Project at a glance

Active
Stars
2,704
Watchers
2,704
Forks
547
LicenseGPL-2.0
Repo age13 years old
Last commit18 hours ago
Primary languagePython

Last synced 3 hours ago