Karrio Dashboard is a browser-based logistics and shipping app for karrio.

If you just want to try Karrio out, check out the karrio/dashboard Docker Image to give it a whirl.

These instructions will get you a copy of the project up and running on your local machine for development and testing purposes.

• Node.js v14+
• A running instance of karrio server.

Clone the repository

git clone https://github.com/karrioapi/karrio-dashboard.git
cd karrio-dashboard
npm install

Use the following environment variables to configure the dashboard:

• JWT_SECRET (required) - A secret to use for JWT key generation - you should set this explicitly.

• DASHBOARD_URL (required) - The URL of your dashboard to restrict the authentication host to your instance. If you are running the dashboard locally, set DASHBOARD_URL to: http://localhost:3000.

• KARRIO_PUBLIC_URL (required) - URL of a running instance of karrio server. If you are running karrio-server locally with the default settings, set KARRIO_PUBLIC_URL to: http://localhost:5002.

• KARRIO_URL (optional) - The internal network karrio API url.

Start the development server

npm run dev

Karrio Dashboard should now be running at http://localhost:3000.

Build the application bundle

npm run build

• Documentation
• Github Community
• Issue Tracker
• Blog

Join us on Discord

This project is licensed under the terms of the Apache 2 license.

See the LICENSE file for license rights and limitations.

Any other questions, mail us at [email protected] We’d love to meet you!