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:
-
NEXT_PUBLIC_KARRIO_API_URL
(required) - URL of a running instance of karrio server. If you are running karrio-server locally with the default settings, setNEXT_PUBLIC_KARRIO_API_URL
to:http://localhost:5002
. -
JWT_SECRET
(required) - A secret to use for JWT key generation - you should set this explicitly. -
NEXTAUTH_URL
(required) - The URL of your dashboard to restrict the authentication host to your instance. If you are running the dashboard locally, setNEXTAUTH_URL
to:http://localhost:3000
. -
KARRIO_HOSTNAME
- URL of a running instance of karrio server. Useful for an internal network request from the node side of the dashboard. Note: the default value will beNEXT_PUBLIC_KARRIO_API_URL
when not provided -
BASE_PATH
- A base path to use for deploying the dashboard to a domain subpath. e.g.instance.karrio.io/dashboard
Start the development server
npm run dev
Karrio Dashboard should now be running at http://localhost:3000.
Build the application bundle
npm run build
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!