Turnkey Container Deployment Launch and run on your private server in minutes
Turnkey Docker and Rootless Podman orchestration with smart MySQL and Redis service detection. Fast China clone via GitCode and global access via GitHub. 100% data ownership with zero platform commission.
# 1. Clone the repository (Global GitHub)
git clone https://github.com/hoxiai/shoply.git
cd shoply
# 2. Launch services (Smart port detection & interactive setup)
./shoply.sh start3 Steps to Deploy Your Storefront
Supports public cloud VPS, internal isolated environments and rootless containers
Prepare Server & Containers
Prepare a 2 vCPU / 4GB RAM server running Linux (Ubuntu/Debian/CentOS), macOS, or Windows WSL2 with Docker 20.10+ or Podman 4.0+ installed.
Clone & Start Services
Clone the repo from GitCode or GitHub and run ./shoply.sh start. The wizard detects host ports and configures the environment automatically.
Configure Reverse Proxy & Launch
Bind your domain and SSL certificate using our production Nginx or Caddy reverse proxy templates to immediately launch your storefront.
Why Deploy Shoply On-Premise?
High-concurrency transaction engine with complete data ownership and zero revenue share
Docker & Podman Out of the Box
Native rootless support on unprivileged port 5490 with SELinux :Z volume mounts for robust security.
Smart Service Detection
Scans host ports 3306 (MySQL) and 6379 (Redis). Directly connects if present, or spins up containers automatically.
Go Engine + Nuxt 4 SSR
Go transaction engine delivers ultra-fast concurrency, while Nuxt 4 SSR ensures top-tier SEO and sub-second page loads.
Extensible PHP Application Ecosystem
Built-in plugin framework allows live customizations, custom workflows, and localized payment integrations.
100% Data Sovereignty
Orders, customer lists, products, and media remain on your private server. No vendor lock-in or revenue share.
Automated Operations CLI
Manage your instance easily with ./shoply.sh. Supports smooth online updates with automated backup rollback.
Effortless Management with shoply.sh
Manage your full container lifecycle via a single turnkey script
Start all services (launches setup wizard on first run)
Check container health status and runtime metrics
Gracefully stop all running Shoply containers
Safely reload configuration, .env, and restart
Follow real-time application runtime logs
Check and perform smooth updates with auto-rollback
server {
listen 80;
server_name mall.yourdomain.com;
return 301 https://$host$request_uri;
}
server {
listen 443 ssl http2;
server_name mall.yourdomain.com;
ssl_certificate /path/to/fullchain.pem;
ssl_certificate_key /path/to/privkey.pem;
client_max_body_size 50m;
location / {
proxy_pass http://127.0.0.1:5490;
proxy_set_header Host $host;
proxy_set_header X-Real-IP $remote_addr;
proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
proxy_set_header X-Forwarded-Proto $scheme;
# WebSocket support for AI Chat & real-time events
proxy_http_version 1.1;
proxy_set_header Upgrade $http_upgrade;
proxy_set_header Connection "upgrade";
}
}Multi-OS & Architecture Support
Run anywhere Docker or Podman runs across x86_64 and ARM64 architectures
Linux
Ubuntu / Debian / CentOS / UOS / Kylin
macOS
macOS 12 Monterey and later
Windows
Windows 10/11 / Windows Server 2016+
Need Enterprise Support or Custom Deployment?
Our senior system architects are ready to assist with high-availability clustering, security audits, and bespoke features.