StilgenStilmerce
Installation

Quick Start

Install Stilmerce on a Linux server in minutes. Fill in your details and copy the generated commands.

Quick Start

Fill in your server details once — every command updates automatically. Then follow the 4 steps in order.

Fill in your server details once. All commands below update automatically.

Optional — paste for a one-copy scp command

Step 1 — Upload ZIP to Server

bash
scp stilmerce-v1.0.0.zip ubuntu@your-server-ip:/tmp/

Step 2 — Create Config File (on server)

SSH into your server and paste this command. It creates the config file the installer reads — no interactive prompts.

bash
cat > /tmp/stilmerce-install.env <<'EOF'
SSL_EMAIL=admin@example.com
APP_API_PORT=4000
APP_FRONT_PORT=3000
APP_ADMIN_PORT=3001
HEALTH_ENABLED=yes
SWAGGER_ENABLED=no
FRONT_DOMAIN=shop.example.com
ADMIN_DOMAIN=admin.example.com
API_DOMAIN=api.example.com
ADMIN_EMAIL=admin@example.com
ADMIN_FIRST_NAME=Admin
ADMIN_LAST_NAME=User
ADMIN_PASSWORD=StrongPass123
DB_NAME=stilmerce
DB_USER=stilmerce_user
DB_PASS=StrongDbPass123
REDIS_ENABLED=yes
EOF

Step 3 — Run the Installer

bash
ssh ubuntu@your-server-ip
sudo apt update && sudo apt install -y unzip curl ca-certificates
unzip stilmerce-v1.0.0.zip
cd stilmerce-v1.0.0
bash install-stilmerce.sh -- --config=/tmp/stilmerce-install.env

The installer installs dependencies, configures PostgreSQL & Redis, builds the apps, runs migrations, creates your admin account, sets up PM2 & Nginx, and provisions SSL.

Step 4 — Verify

bash
sudo pm2 ls
sudo nginx -t
systemctl is-active nginx postgresql redis-server
curl -s https://api.example.com/health

What the Installer Does

  1. Validates OS, ports, and DNS
  2. Installs system packages (Nginx, PostgreSQL, Redis, Node.js, PM2, Certbot)
  3. Creates the database and runs migrations
  4. Creates the initial admin account
  5. Builds API, Admin, and Storefront apps
  6. Starts services with PM2
  7. Configures Nginx reverse proxy
  8. Requests SSL certificates (skipped if DNS not ready)
  9. Runs a health check and prints your store URLs

After Install

Your store is ready at:

URLDescription
https://shop.example.com/enStorefront
https://admin.example.com/adminAdmin dashboard
https://api.example.com/healthAPI health check

For local or LAN testing without a domain, pass --skip-ssl to the install command and use domains like api.localtest.me. Add the server IP to your /etc/hosts file.

Local / LAN Install (no DNS)

bash install-stilmerce.sh --skip-ssl -- --config=/tmp/stilmerce-install.env

When ready, re-run the installer without --skip-ssl to provision SSL automatically.

On this page