/karrio-dashboard

The Open Source Shipping dashboard for karrio

Primary LanguageTypeScriptApache License 2.0Apache-2.0

Karrio Dashboard

Karrio Dashboard

karrio-dashboard

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

Getting Started

Using a Karrio Dashboard Release

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

Building and Running Karrio Dashboard

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

Prerequisites

Installing

Clone the repository

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

Configuration

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.

Development

Start the development server

npm run dev

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

Production

Build the application bundle

npm run build

Resources

Join us on Discord

License

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 hello@karrio.io We’d love to meet you!