Preferred way to run Kaopu 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 http://127.0.0.1:8000/ in your browser to see your Kaopu installation.

Admin Control Panel is available under the http://127.0.0.1:8000/admincp/ 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.

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 manage.py migrate - runs migrations
3. docker-compose run --rm misago python manage.py createsuperuser - creates test user
4. docker-compose up - starts dev server