Skip to main content

Developing Karrio

Documentation for developers contributing to the Karrio code base.



The following steps need to be performed inside a terminal window (Windows user may prefer to use the Windows WSL).

Clone the repository:

git clone
cd karrio


Setup a PostgreSQL database for the application.

docker-compose up -d db

Installation using Python

  • Setup Python environment with the dependencies:
. ./scripts/
  • Apply database migrations, collect static assets:
karrio migrate
karrio collectstatic --noinput
  • Finally, create yourself an admin account:
karrio createsuperuser
  • Start the server:
karrio runserver

On windows, use instead of localhost:5002


git clone
cd karrio-dashboard
  • Install node dependencies:
npm install
  • Setup environment variables:
cp .env.sample .env

On windows set up: NEXT_PUBLIC_KARRIO_API_URL=http://localhost:5002

  • Start the dashboard:
npm run dev


Make sure Docker and Docker Compose work before attempting to run Karrio. We won't be able to assist with your Docker installation.

Make sure you've read the warning about Windows 10 Home. Windows versions before Windows 10 are not officially supported.

If you encounter other problems, see Support.