Openship

Quick Start

Getting Started with Openship

Introduction

Openship is an order routing platform that connects the places where you're selling to the places where you're fulfilling. It automatically routes orders from your sales channels to your fulfillment partners, giving you complete control over your order flow.

Automatic Installation

A minimum version of Node.js 20 required.

git clone https://github.com/openship-org/openship.git
cd openship
npm install

Environment Setup

Create a .env file in the root directory:

# Required: Change this to a secure random string
SESSION_SECRET=your-super-secret-session-key-here

# Required: Your PostgreSQL database connection string
DATABASE_URL=postgresql://username:password@localhost:5432/openship

# Optional: SMTP configuration for email notifications
SMTP_FROM="no-reply@yourdomain.com"
SMTP_HOST="your-smtp-host"
SMTP_PASSWORD="your-smtp-password"
SMTP_PORT="587"
SMTP_USER="your-smtp-user"

Start Development

Run the development server:

npm run dev

This will:

  • Build the Keystone schema
  • Run database migrations
  • Start the development server

Open http://localhost:3000 with your browser to see the result.

Enjoy!

Your Openship instance is now running! Start by connecting your first shop and setting up fulfillment channels.