Skip to content



This documentation is a for legacy version of the purplship-server (up to 2021.7).

Please visit for the latest documentation.

What's purplship server?

purplship server is a headless shipping platform for innovators who want to regain control over their logistics processes and fulfilment automation. The server is a self-hosted Multi-carrier Shipping API based on Django and purplship SDK.

You can use any programming language to send API requests to our growing network of shipping carriers from your app.


  • Headless shipping API: Power up your application with access to a network of carrier services
  • Multi-carrier: Integrate purplship once and connect to multiple shipping carrier APIs
  • Shipping: Connect carrier accounts, get live rates and purchase shipping labels
  • Tracking: Create package tracker, get real time tracking status and provide a branded tracking page
  • Address Validation: Validate shipping addresses using the Google Geocoding API
  • Shipping Web App: Use a single dashboard to orchestrate your logistics operation.
  • Cloud: Optimized for deployments using Docker

Quick Start

It takes less than 5 minutes to run and install purplship using Docker:

  • Start a Postgres database
docker run -d \
  --name db --rm \
  -e POSTGRES_DB=db \
  -e POSTGRES_USER=postgres \
  -e POSTGRES_PASSWORD=postgres \
  • Run your shipping server

Find a specific version of purplship/purplship-server

docker run \
  --name pship --rm \
  -e DEBUG_MODE=True \
  -e \
  -e ADMIN_PASSWORD=demo \
  --link=db:db -p 5002:5002 \

Once the server is ready access your shipping dashboard at, log in with the default admin account | demo


If you get stuck or need help, file an issue, post on the community board or email.

Check install for more details