System Requirements
Everything SaleX needs on your computer (for development) or server (for production). Check this list before installing.
On this page
For local development
| Requirement | Minimum | Notes |
|---|---|---|
| Operating system | Windows 10/11 (64-bit) or macOS 12+ | Linux works identically to macOS in the terminal. |
| Node.js | v20 LTS or newer (v22 recommended) | SaleX uses Next.js 16, which requires Node 20+. Download the “LTS” installer from nodejs.org. |
| npm | Included with Node.js | Check with npm -v. pnpm also works (a lockfile is included). |
| PostgreSQL | 14 or newer | The database engine. Install locally, or use a free hosted database (Supabase, Neon) — then skip the local install. |
| RAM | 4 GB (8 GB comfortable) | The dev server compiles pages on the fly. |
| Disk space | ~2 GB | Dependencies plus uploads. |
| Browser | Current Chrome, Edge, Firefox, or Safari | For using the storefront and admin panel. |
No PHP needed
SaleX is not a PHP/WordPress script. It is a Node.js application — there is nothing to upload to cPanel shared PHP hosting. See Choosing hosting below.
Check your versions
Open a terminal (Windows: PowerShell; macOS: Terminal) and run each command. Success looks like a version number, not an error.
node -v # should print v20.x.x or newer
npm -v # should print a version like 10.x.x
psql --version # PostgreSQL: should print 14 or newer (if installed locally)For production
| Requirement | Recommendation | Notes |
|---|---|---|
| Server | VPS / cloud VM, 2 vCPU, 4 GB RAM, Ubuntu 22.04+ | Any Linux server you can SSH into works. |
| Node.js | v20 LTS or newer (same as local) | Production runs the built app with npm run start or a process manager. |
| PostgreSQL | Managed service (Supabase, Neon, RDS) or on-server | Managed backups are strongly recommended. |
| Reverse proxy | Nginx or Caddy | Handles HTTPS and forwards traffic to the app port (3000). |
| HTTPS certificate | Let's Encrypt (free) via Certbot | Required for logins and payments. |
| Process manager | pm2 or systemd service | Keeps the app running and restarts it after crashes/reboots. |
Choosing hosting
| Hosting type | Compatible? | Why |
|---|---|---|
| Shared PHP hosting (cPanel “PHP hosting”) | Not compatible | Cannot run Node.js applications or persist a Node process. |
| VPS (DigitalOcean, Hetzner, Vultr, Linode, Contabo…) | Yes | Full control; documented in Server Deployment and DigitalOcean VPS Setup. PostgreSQL can run on the same server. |
| Node-friendly PaaS (Render, Railway, Fly.io) | Yes | Set the start command and environment variables; managed Postgres available. |
| Managed Next.js (Vercel) | Partially — needs review | Next.js itself deploys, but SaleX writes uploaded media to the local storage/ folder, which is ephemeral on serverless platforms. Use an external storage/database strategy or a long-running server instead. |
| Static hosts (Netlify static, GitHub Pages) | Not compatible | SaleX is a dynamic server application, not a static site. |
Local uploads
Product images are stored on the server disk (folder
storage/) in the default configuration. On any host where the disk resets (some container platforms), uploaded files disappear on redeploy — back up this folder or use a host with persistent disk. See Database & Storage.