Skip to content

overview.md

Latest commit

 

History

History
72 lines (54 loc) · 1.89 KB

overview.md

File metadata and controls

72 lines (54 loc) · 1.89 KB

Deployment Overview

Deploy LogisticsX to a production VPS using Docker Compose generated by .NET Aspire.

Quick Start

# On your VPS
git clone https://github.com/suxrobgm/logistics-app.git
cd logistics-app/src/Aspire/Logistics.Aspire.AppHost/aspire-output

# Configure environment
cp .env.example .env
# Edit .env with your production values

# Deploy
docker compose up -d

Architecture

Internet -> Nginx (80/443 with SSL)
               |-- api.domain.com    -> API (:7000)
               |-- id.domain.com     -> Identity Server (:7001)
               |-- admin.domain.com  -> Admin App (:7002)
               +-- office.domain.com -> Office App (:7003)
                         |
                         v
                    PostgreSQL

System Requirements

Resource Minimum Recommended
CPU 2 vCPU 4 vCPU
RAM 4 GB 8 GB
Storage 40 GB SSD 80 GB SSD
OS Ubuntu 22.04 LTS Ubuntu 24.04 LTS

Deployment Steps

  1. VPS Setup - Install Docker and configure server
  2. Deploy with Docker Compose - Configure and run services

DNS Configuration

Create DNS A records pointing to your VPS IP:

api.yourdomain.com      -> YOUR_VPS_IP
id.yourdomain.com       -> YOUR_VPS_IP
admin.yourdomain.com    -> YOUR_VPS_IP
office.yourdomain.com   -> YOUR_VPS_IP

Pre-deployment Checklist

  • VPS with SSH access
  • Domain with DNS configured
  • Stripe API keys (for payments)
  • Resend API key (for emails)
  • Mapbox access token (for maps)

Guides

Guide Description
VPS Setup Initial server configuration
Docker Compose Deployment Deploy with pre-generated docker-compose
Environment Variables Configuration reference