Self-hosted order management

Run the shop. Not the group chat.

VendKit brings orders, stock, customers, payments, invoices, delivery and backups into one calm workspace. Install it on your own server and keep the records that run your business.

  • One business per install
  • Docker Compose
  • PostgreSQL
  • AGPL-3.0
Dashboard
VendKit dashboard showing revenue, order count, average order value, customers, inventory alerts and a revenue chart.

The daily mess

The order is in the chat. The stock is in your head.

Selling through messages works until it doesn't. Orders get lost between conversations, stock disagrees with reality, and the invoice is rebuilt by hand every time. VendKit gives that work a place to live — without moving your business onto someone else's platform.

  • Orders arrive on Facebook, Instagram, WhatsApp and the phone — then stay there.
  • Stock lives in a notebook, a memory, or a spreadsheet nobody trusts.
  • Payments are partial, mixed and scattered across screenshots.
  • The month ends before the totals do.

What every order keeps with it

Order
Order
Number, date and current status
Channel
Where the sale came from
Payment
Paid, partial or unpaid
Delivery
Courier and tracking number
History
Notes and an activity timeline

The same record holds the customer, the items, the stock movement and the invoice.

Inside VendKit

The back office, built around the order.

Four connected areas do the everyday work: selling, stock, documents and the copy of your data. No separate tools to reconcile at the end of the day.

Orders & delivery

Every order, with its whole story.

Create an order with the customer, product lines, shipping and sales channel. Record payments as they arrive, add courier and tracking details, and follow the order through a full activity timeline.

  • Search, filter and export the current order view to CSV
  • Partial payments and outstanding balances
  • Cancel, return and restore stock automatically
  • Pre-filled WhatsApp hand-off — no Business API
Orders & delivery
VendKit order editor with customer details, product lines, delivery fields, notes and live totals.
Order editor: products, quantities, shipping and notes with stock adjustments applied.

Catalog & inventory

Stock that moves when the order does.

Set stock levels and low-stock thresholds per product. VendKit deducts stock when orders are placed, restores it on cancellation or return, and keeps an auditable movement history.

  • Immutable stock movement history
  • Low-stock and out-of-stock alerts
  • SKUs, categories, brands and product images
  • Reusable media library with usage protection
Catalog & inventory
VendKit inventory page listing products, stock levels, low-stock indicators and movement history.
Inventory: tracked stock, thresholds and the audit trail behind every movement.

Invoices & reports

Documents and totals without the spreadsheet.

Issue one numbered invoice per order, download it as a PDF, and keep numbering, terms and business details in Settings. Reports turn the same records into revenue, channel mix, top products and top customers.

  • Draft, issued and cancelled invoice states
  • Configurable numbering, branding and terms
  • Revenue, order status, channel and daily sales
  • CSV exports with spreadsheet-safe escaping
Invoices & reports
VendKit reports page showing revenue KPIs, sales chart, order status breakdown, channel mix, top products and top customers.
Reports: daily sales, status and channel breakdowns, top products and customers.

Backup & restore

A complete copy. A restore that finishes.

Download a versioned archive containing the catalog, customers, orders, payments, invoices, inventory history, settings and media. Restores are checksum-verified and transactional; a safety backup can be made first.

  • Archives exclude users, sessions and server secrets
  • Validated restore inside one transaction
  • Optional safety snapshot before restoring
  • Stored on your disk, under your backup policy
Backup & restore
VendKit backup and restore settings showing backup creation, restore warnings and the data included in an archive.
Backup & restore: one archive, with a warning before anything is replaced.

From message to delivered

A workflow you can actually follow.

VendKit uses the statuses a social seller already thinks in. Each step updates the order and keeps the history attached.

  1. 01

    Pending

    Capture the customer, products and channel. Stock is deducted when the order is created.

  2. 02

    Confirmed

    Confirm payment details and delivery information. Partial payments stay visible as outstanding.

  3. 03

    Processing

    Prepare the items and keep notes on the order. The activity timeline shows what changed.

  4. 04

    Shipped

    Save the courier and tracking number so the hand-off is not buried in a chat.

  5. 05

    Delivered

    Close the order with its payment record and issue the invoice when it is ready.

Cancelled orders and returns put stock back where it belongs.

From a server to your first order.

VendKit is deployed like software you own: a Compose stack, a database, two secrets and a first-run account.

01

Put it on your server

Clone the repository, create an environment file and start the stack. The API applies database migrations when it boots.

02

Create the first account

The first account becomes the administrator. Public sign-up closes afterward; add the rest of the team from Team.

03

Describe the business

Set business details, invoice numbering, currency, tax and shipping defaults. They live in the database, so backups include them.

04

Start recording

Add categories, brands and products, then create an order. The dashboard checklist shows what is still missing.

Read the installation guide
Terminal
Clone → start
$ git clone https://github.com/MuawiyahDev/vendkit.git$ cd vendkit$ cp .env.example .env$ openssl rand -hex 32$ docker compose up -d --build

Set POSTGRES_PASSWORD, JWT_SECRET and API_KEY in .env first. The full copy-paste runbook is in the documentation.

Next.jsNestJSPostgreSQL

What you need

  • Docker with the Compose plugin
  • Persistent storage for the database and uploads
  • A reverse proxy with HTTPS for public access

Ownership

Your business. Your database. Your copies.

VendKit is a single-business application you install yourself. There is no vendor account, no multi-tenant control plane, and no subscription between you and your records.

One business per install

No shared tenancy, no workspace switcher and no hidden tenant layer.

PostgreSQL plus two volumes

Business data in PostgreSQL; images and backup archives on storage you control.

The API stays private

The browser talks to Next.js, which proxies to the API server-side with a shared key.

Open source under AGPL-3.0

Inspect, modify and run it. Share modifications if you run them as a network service.

How a request moves

HTTPS · server-side
BrowserNo direct API access
Next.js web appServer-side proxy
NestJS APIShared API key
PostgreSQLImages & backups · Persistent volumes

Where it fits

Built for one business at a time.

VendKit is deliberately not a marketplace. It is the operations layer behind the places you already sell.

  • Messaging-first sellers

    Selling through Facebook, Instagram, WhatsApp or TikTok.

    Keep every conversation-led sale in one record, with the channel, customer and payment history attached.

  • Small catalog shops

    A focused product range that needs stock and documents.

    Track inventory, issue invoices and follow delivery without adopting a full storefront or ERP.

  • Hands-on operators

    You want the server, database and backups under your control.

    Run the stack yourself, keep the data on your own disk, and make copies you can actually restore.

  • Small teams

    More than one person keeping the business moving.

    Give each person a separate sign-in. Administrators manage the team and reset passwords.

Before you install

Questions worth asking first.

Short answers about hosting, scope, data and the parts VendKit deliberately does not do.

Read all questions

VendKit is a self-hosted order management application for social-commerce sellers. It keeps orders, products, inventory, customers, payments, invoices, delivery tracking, reports, team accounts and backups in one workspace.

Self-hosted · Single-business · Open source

Bring the business back into one place.

Start with the documentation, put VendKit on a server you control, and run your first order end to end.

Read the documentationView on GitHub

No sign-up, no trial and no pricing page. VendKit is software you run.