Skip to content
Misago is fully featured modern forum application that is fast, scalable and responsive.
Python JavaScript HTML CSS Other
Branch: master
Clone or download
imvieira and rafalp Update Dockerfile (#1314)
The line 28 contained the string "    pip install -r requirements-plugins.txt &&" which caused the error ```/bin/sh: 1: Syntax error: end of file unexpected
Service 'misago' failed to build: The command '/bin/sh -c pip install --upgrade pip &&     pip install -r requirements.txt &&     pip install -r requirements-plugins.txt &&' returned a non-zero code: 2```
Therefore, I removed the characters "&&" and solved. 
Finally, following my suggestion of modification on this Dockerfile. Thank you, Igor
Latest commit 58a0c45 Oct 15, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.tx Sync translation files with transifex Feb 24, 2018
devproject Added hooks for urls/api/context processors (#1309) Oct 6, 2019
frontend Fixed typos, translation files (#1304) Oct 5, 2019
misago Bump version to 0.24.1 Oct 13, 2019
.dockerignore Tweaked docker setup a little, fixed eventual clashes in migration Mar 31, 2018
.eslintrc.json Add eslint Apr 29, 2019
.gitattributes Force LF line endings in bash scripts Jun 9, 2018
.gitignore Remove optional whitespace from short image markdown (#1290) Sep 15, 2019
.isort.cfg Tweak isort config, add ./dev fmtpy shorthand for isort + black Dec 23, 2018
.pylintrc Add format to pylint disables Dec 25, 2018
.travis.yml Extra cleanups after Django 2.2 (#1229) May 18, 2019
Dockerfile Update Dockerfile (#1314) Oct 15, 2019
LICENSE.rst Fixed formatting of license text Jan 30, 2015 Remove extras from manifest Sep 9, 2018
README.rst Bump version to 0.24.1 Oct 13, 2019
dev Add fakebigdata shortcut Feb 2, 2019
docker-compose.yaml Replaced tasks with devproject for celery service Dec 31, 2018 Remove project template Nov 3, 2018
package-lock.json First pass on admin analytics May 5, 2019
package.json First pass on admin analytics May 5, 2019
plugins.txt Add plugin loading to Misago (#1306) Oct 5, 2019
pytest.ini Change testrunner to pytest Dec 20, 2018 Add plugin loading to Misago (#1306) Oct 5, 2019
requirements-plugins.txt Add plugin loading to Misago (#1306) Oct 5, 2019 Add SSO user sync api (#1282) Aug 25, 2019
requirements.txt Add SSO user sync api (#1282) Aug 25, 2019 Format with black Jul 21, 2019
webpack.config.js Extract admin moment.js locales to separate files, load them lazily May 3, 2019



Tests Result Test Coverage Release 0.24.1 Works on Python 3.7 Community Chat

Development Status: 🍌 Bananas 🍌

Misago aims to be complete, featured and modern forum solution that has no fear to say 'NO' to common and outdated opinions about how forum software should be made and what it should do.


Forum index Thread view

Production use

As of now Misago implements all features considered "must have" on live internet forum:

  • Your users may register accounts, set avatars, change options and edit their profiles. They have option to reset forgotten password.
  • Sign in with Facebook, Google, Github, Steam, or any other over 50 supported OAuth providers.
  • Site admins may require users to confirm validity of their e-mail addresses via e-mail sent activation link, or limit user account activation to administrator action. They can use custom Q&A challenge, ReCAPTCHA, Stop Forum Spam or IP's blacklist to combat spam registrations. Pletora of settings are available to control user account behaviour, like username lengths or avatar restrictions.
  • Create categories together with unlimited number and depth of subcategories.
  • Write messages using either GitHub flavoured markdown, BBCode subset, or both.
  • Presence features let site members know when other users are online, offline or banned. Individual users have setting to hide their activity from non-admins.
  • Complete moderation toolset allowing admin-approved moderators to edit, move, hide, approve, delete or close user posted content. This also includes option to delete or block user accounts or avatars.
  • Ban system allows you to ban existing users as well as forbid certain user names, e-mails or IP addresses from registering accounts.
  • Permission system allowing you to control which features are available to users based on their rank, roles or category they are in.
  • Post accurate read tracker that lets your users spot threads with new posts as well as let moderators spot unapproved replies and non-moderators spot approved posts.
  • Private threads feature allowing users to create threads visible only to them and those they've invited.
  • Python-based profile fields framework letting site owners to define custom fields for users to fill in complete with powerful customization options for custom requirements, display or validation logic.
  • Rich polls system, allowing polls with public and private voters, single and multiple choices as well as ones that allow vote change or limit voting tp limited period of time.
  • Post attachments complete thumbnailing and gif's animation removal.
  • Mark post in question thread as best answer, bringing basic Q&A functionality.
  • Posts edits log allowing you to see how user messages used to look in past as well as revert function protecting you from malignant users emptying their posts contents.
  • Moderation queue for users and categories allowing you to moderate content before it becomes visible to other members of the community.
  • Custom theme developed over bootstrap.
  • Features and settings for achieving GDPR compliance.
  • Integrate forum with your site using implemented Single Sign On client and JSON API.

Even more features will follow in future releases:

  • Forum-wide JS routing further reducing navigation times.
  • Replacing current API with GraphQL API for easier integrations and extending.
  • Plugin system to extend core package with new features.
  • WYSIWYM content editor for even easier post formatting.
  • Ranking system for forum search results based on post links, likes, author and thread importance.


Preferred way to run Misago development instances on your machine is with Docker, which makes it easy to spin up arbitrary number of instances running different code with separate databases and dependencies besides each other.

To start, clone the repository and run ./dev init command in your terminal. This will build necessary docker containers, install python dependencies and initialize the database. After command does its magic, you will be able to start development server using the docker-compose up command.

After development server starts, visit the in your browser to see your Misago installation.

Admin Control Panel is available under the address. To log in to it use Admin username and password password.

The ./dev utility implements other features besides the init. Run it without any arguments to get the list of available actions.

Running Misago in development without dev

You may skip ./dev init and setup dev instance manually, running those commands:

  1. docker-compose build - builds docker containers
  2. docker-compose run --rm misago python migrate - runs migrations
  3. docker-compose run --rm misago python createsuperuser - creates test user
  4. docker-compose up - starts dev server


With exception of Admin Panel, Misago frontend relies heavily on React.js components backed by Django API. This application relies on custom Gulp.js-based toolkit for development. As of current, Misago's gulpfile.js defines following tasks:

  • build does production build of Misago's assets, concating and minifying javascripts, css and images, as well as moving them to misago/static directory
  • watch does quick build for assets (concat assets into single files, compile less, deploy to misago/static but don't minify/optimize) as well as runs re-build when less/js changes
  • watchstyle does quick build of less files, and re-builds them when they change
  • test runs Mocha.js tests suite for Misago's javascript

To start work on custom frontend for Misago, fork and install it locally to have development forum setup. You can now develop custom theme by modifing assets in frontend directory, however special care should be taken when changing source javascripts.

Misago defines template that allows you to include custom html and js code before Misago's JavaScript app is ran, named scripts.html.

Bug reports, features and feedback

If you have found bug, please report it on issue tracker.

For feature or support requests as well as general feedback please use official forum instead. Your feedback means much to the project so please do share your thoughts!

There's also Gitter for those looking for instant-messaging approach for discussing Misago development.


If you have corrected spelling, wrote new tests or fixed a bug, feel free to open pull request.

Many issues are open for takers. If you've found one you feel you could take care of, please announce your intent in issue discussion before you start working. That way situations when more than one person works on solving same issue can be avoided.


Rafał Pitoń

English sentences used within misago.faker.phrases were extracted from National Aeronautics and Space Administration Solar System Exploration Portal and are not copyrighted as per Media and content usage guidelines.

Copyright and license

Misago - Copyright © 2018 Rafał Pitoń This program comes with ABSOLUTELY NO WARRANTY.

This is free software and you are welcome to modify and redistribute it under the conditions described in the license. For the complete license, refer to LICENSE.rst

You can’t perform that action at this time.