Openfront

Quick Start

Getting Started with Openfront

Introduction

Openfront is a comprehensive e-commerce platform that provides everything you need to run an online store. It includes a complete admin dashboard, customer storefront, payment processing, and inventory management.

Automatic Installation

A minimum version of Node.js 20 required.

git clone https://github.com/openshiporg/openfront.git
cd openfront
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/openfront

# 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 Openfront instance is now running! Start by setting up your store, adding products, and configuring your e-commerce settings.