Getting started

Creating your first MoWAKi project is as simple as:

curl -sL | bash -s - ./newproject

Or if you don’t feel like running some untrusted script from the Internet, have a look at the source code here.

Also, visit the MoWAKi project on GitHub for more information.

Installing dependencies

Backend dependencies can be installed via pipenv:

pipenv install

Frontend dependencies can be installed using npm:

cd web && npm install


Create an .env file containing the necessary configuration:


Note: DATABASE_URL and REDIS_URL are only needed if you’re going to use those services, see below.

Running in development mode

Start the backend service:

pipenv run start

Start the frontend build / server:

cd web && npm start

Using a database

The project is pre-configured for quickly setting up a PostgreSQL database.

A PostgreSQL 10 instance can be started using docker-compose:

docker-compose up

To run the necessary database migrations:

pipenv run alembic upgrade head