Vendure

[*]Key Features

• [+]Dual GraphQL APIs with separate shop and admin endpoints for secure role-based access
• [+]Built-in admin UI with comprehensive product, order, and customer management capabilities
• [+]Extensible plugin architecture supporting custom payment processors, shipping calculators, and business logic
• [+]Multi-channel support for managing different storefronts, currencies, and tax zones
• [+]Advanced product modeling with variants, facets, and collections for complex catalog structures
• [+]Real-time inventory tracking with stock allocation and backorder management
• [+]Flexible promotion engine supporting percentage, fixed amount, and tiered discount strategies
• [+]PostgreSQL integration with optimized queries for e-commerce operations and full-text product search

[#]Common Use Cases

• [1]Building custom storefronts with React, Vue, or Angular while leveraging a robust commerce backend
• [2]Creating multi-brand e-commerce platforms where each brand needs distinct catalogs and pricing
• [3]Developing B2B commerce solutions with custom pricing tiers and approval workflows
• [4]Migrating from Shopify Plus or Magento to a more flexible, developer-controlled platform
• [5]Building marketplace platforms that require complex vendor management and commission structures
• [6]Creating omnichannel retail experiences that sync inventory across web, mobile, and POS systems
• [7]Developing subscription commerce platforms with recurring billing and customer lifecycle management

[!]Prerequisites

• [!]Minimum 2GB RAM recommended for combined Vendure and PostgreSQL operations
• [!]Port 3000 available for Vendure GraphQL APIs and admin interface access
• [!]Basic understanding of GraphQL queries and mutations for API integration
• [!]Node.js and TypeScript knowledge for customizing Vendure plugins and configuration
• [!]Familiarity with PostgreSQL for database optimization and backup strategies
• [!]Understanding of headless commerce concepts and API-driven frontend development

[$]docker-compose.yml

1services: 
2  vendure: 
3    image: vendure/vendure:latest
4    container_name: vendure
5    restart: unless-stopped
6    environment: 
7      DB_HOST: postgres
8      DB_PORT: 5432
9      DB_NAME: ${DB_NAME}
10      DB_USERNAME: ${DB_USER}
11      DB_PASSWORD: ${DB_PASSWORD}
12    ports: 
13      - "3000:3000"
14    depends_on: 
15      - postgres
16    networks: 
17      - vendure
18
19  postgres: 
20    image: postgres:16-alpine
21    container_name: vendure-postgres
22    environment: 
23      POSTGRES_DB: ${DB_NAME}
24      POSTGRES_USER: ${DB_USER}
25      POSTGRES_PASSWORD: ${DB_PASSWORD}
26    volumes: 
27      - postgres_data:/var/lib/postgresql/data
28    networks: 
29      - vendure
30
31volumes: 
32  postgres_data: 
33
34networks: 
35  vendure: 
36    driver: bridge

[$].env Template

1DB_NAME=vendure
2DB_USER=vendure
3DB_PASSWORD=changeme

[i]Usage Notes

Individual Services(2 services)

Copy individual services to mix and match with your existing compose files.

vendure:
  image: vendure/vendure:latest
  container_name: vendure
  restart: unless-stopped
  environment:
    DB_HOST: postgres
    DB_PORT: 5432
    DB_NAME: ${DB_NAME}
    DB_USERNAME: ${DB_USER}
    DB_PASSWORD: ${DB_PASSWORD}
  ports:
    - "3000:3000"
  depends_on:
    - postgres
  networks:
    - vendure

postgres:
  image: postgres:16-alpine
  container_name: vendure-postgres
  environment:
    POSTGRES_DB: ${DB_NAME}
    POSTGRES_USER: ${DB_USER}
    POSTGRES_PASSWORD: ${DB_PASSWORD}
  volumes:
    - postgres_data:/var/lib/postgresql/data
  networks:
    - vendure

[>]Quick Start

1# 1. Create the compose file
2cat > docker-compose.yml << 'EOF'
3services:
4  vendure:
5    image: vendure/vendure:latest
6    container_name: vendure
7    restart: unless-stopped
8    environment:
9      DB_HOST: postgres
10      DB_PORT: 5432
11      DB_NAME: ${DB_NAME}
12      DB_USERNAME: ${DB_USER}
13      DB_PASSWORD: ${DB_PASSWORD}
14    ports:
15      - "3000:3000"
16    depends_on:
17      - postgres
18    networks:
19      - vendure
20
21  postgres:
22    image: postgres:16-alpine
23    container_name: vendure-postgres
24    environment:
25      POSTGRES_DB: ${DB_NAME}
26      POSTGRES_USER: ${DB_USER}
27      POSTGRES_PASSWORD: ${DB_PASSWORD}
28    volumes:
29      - postgres_data:/var/lib/postgresql/data
30    networks:
31      - vendure
32
33volumes:
34  postgres_data:
35
36networks:
37  vendure:
38    driver: bridge
39EOF
40
41# 2. Create the .env file
42cat > .env << 'EOF'
43DB_NAME=vendure
44DB_USER=vendure
45DB_PASSWORD=changeme
46EOF
47
48# 3. Start the services
49docker compose up -d
50
51# 4. View logs
52docker compose logs -f

[>]One-Liner

Run this command to download and set up the recipe in one step:

1curl -fsSL https://docker.recipes/api/recipes/vendure/run | bash

[?]Troubleshooting