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.
DOWNLOAD & INSTALL
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
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 folderOpens Google Drive in a new tab. Select a file and choose Download, or download the folder as a ZIP.
WHAT THE INSTALLER DOES
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
The installer checks Git, Node.js 20+ and PostgreSQL. Read the included README before making changes to an existing installation.
01 — INSTALLATION
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
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
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.
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
Use the Desktop shortcuts created by the installer or the canonical maintenance scripts in the app folder.
start_sym_pos_hidden.bat
Starts the POS using the hidden launcher. The installer also places the launcher in Windows Startup.
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_sym_pos.bat
Reads PORT from .env, stops the listener on that port, restarts through the hidden launcher and checks /healthz.
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.