SYM POS

DOWNLOAD & INSTALL

Your POS installation starts here.

Get the Windows batch scripts and their README from the shared download folder. Keep all five scripts together, then run install_sym_pos.bat as Administrator to set up your POS computer.

WINDOWS · BATCH SCRIPTS

Installation files and instructions, together.

Open the Google Drive folder to download the .bat scripts and read the accompanying README. Downloads are hosted on Google Drive. Keep install_sym_pos.bat, start_sym_pos_hidden.bat, update_sym_pos.bat, restart_sym_pos.bat and uninstall_sym_pos.bat together for installation.

Open download folder

Opens Google Drive in a new tab. Select a file and choose Download, or download the folder as a ZIP.

WHAT THE INSTALLER DOES

Setup with your existing configuration in mind.

The installer creates or preserves the restaurant_pos database and creates or updates pos_user. It clones or updates the RestaurantPOS repository, creates .env on the first installation and preserves an existing .env when reinstalled.

It installs dependencies, generates Prisma, runs database migrations, type checks and builds the application. Canonical maintenance scripts are copied into the app folder.

HOW TO GET STARTED

Download. Read. Run.

The installer checks Git, Node.js 20+ and PostgreSQL. Read the included README before making changes to an existing installation.

01 — INSTALLATION

Download the files

Open the folder above and download the scripts together with the README and any accompanying files. If Google Drive gives you a ZIP, extract it before running anything.

02 — INSTALLATION

Read the README first

Check Git, Node.js 20+ and PostgreSQL on your Windows computer. Keep all five .bat files together and read the accompanying README before installing.

03 — INSTALLATION

Run the documented script

Right-click install_sym_pos.bat and choose Run as administrator. Follow its prompts and keep the command window open to read completion or error messages. The installer starts the POS and checks /healthz.

Check your installation before your first shift.

The installer creates Desktop shortcuts for Start, Update, Restart and Uninstall, and installs the hidden launcher into Windows Startup. It adds a Private-network firewall rule for the POS port. Use the startup and browser address given in the README. Confirm you can open the POS and sign in, then test your menu, ordering and printer setup before using real orders. Batch scripts run on Windows; they do not run directly on phones, macOS or Linux.

If installation stops, note the script name and error message before contacting support. If a download or Windows security warning appears, confirm the file source before proceeding; do not disable your security software.

AFTER INSTALLATION

Start, update, restart or uninstall.

Use the Desktop shortcuts created by the installer or the canonical maintenance scripts in the app folder.

Start

start_sym_pos_hidden.bat

Starts the POS using the hidden launcher. The installer also places the launcher in Windows Startup.

Update

update_sym_pos.bat

Stops the POS, fetches and resets the app to origin/main, and attempts a pg_dump backup. It installs dependencies, generates Prisma, runs migrations, type checks and builds, then restarts through the hidden launcher and checks /healthz. Local source changes are replaced: preserve them and verify your database backup before updating.

Restart

restart_sym_pos.bat

Reads PORT from .env, stops the listener on that port, restarts through the hidden launcher and checks /healthz.

Uninstall

uninstall_sym_pos.bat

Removes the app, Windows Startup launcher, Desktop shortcuts and firewall rule. PostgreSQL data is preserved by default. Dropping the database and role is optional and requires administrator confirmation. Git, Node.js and PostgreSQL remain installed.