Home > User Guides > Local Backup Setup

Setting Up Local Backup Server

Time Required: 5-10 minutes
Difficulty: Easy
Purpose: Protect your data from browser crashes and clearing

What is the Local Backup Server?

The Local Backup Server is a small program that runs on your computer and automatically saves all your POS data. This means:

Step 1: Install the Backup Server

For Windows Users

  1. Get the installer files

    Your IT administrator should provide you with a folder containing:

    • install.bat
    • trafficpos-backup-server.exe
    • Other support files

  2. Run the installer

    Right-click and run as administrator

    Right-click on install.bat and select "Run as administrator"

  3. Follow the prompts

    When asked "Add to Windows startup?", type Y and press Enter

  4. Installation complete!

    You'll see "Installation complete!" Press any key to close the window.

For Ubuntu/Linux Users

  1. Open Terminal

    Press Ctrl + Alt + T

  2. Install the package

    sudo dpkg -i "TrafficPOS Local Server_1.0.0_amd64.deb"

    Enter your password when prompted

  3. Server starts automatically

    Look for the icon in your system tray

Step 2: Configure TrafficPOS

Local Backup Server Settings

  1. Open Settings

    In TrafficPOS, click the settings icon or navigate to Settings

  2. Go to System Tab

    Click on the "System" tab in settings

  3. Find Local Backup Server Section

    Scroll down to "Local Backup Server"

  4. Enable the Server

    Toggle "Use Local Backup Server" to ON (green)

  5. Test Connection

    Click "Test Connection" - you should see "Connection successful!"

    ✅ Connection successful! Server is running on port 8888

  6. Enable Auto Features

    • Turn ON "Auto-sync" - backs up every 5 minutes
    • Turn ON "Sync on Sale" - backs up after each transaction

  7. Click Sync Now

    Click "Sync Now" to do an initial backup of all your data

Step 3: Verify It's Working

Quick Check

  1. Look at the "Last Sync" time - it should show a recent time
  2. The sync status should show "Synced" in green
  3. Record count should show your data (e.g., "234 products, 1,052 sales")

Test with a Sale

  1. Complete a test sale in the POS
  2. Go back to Settings → System → Local Backup Server
  3. The "Last Sync" time should update within a few seconds

Frequently Asked Questions

Do I need to keep a window open?

No! The backup server runs in the background. You can close all windows and it keeps working.

Will it slow down my computer?

No, the backup server uses very little resources (less than 50MB of RAM).

What if I restart my computer?

The backup server will start automatically when you log in (if you chose that option during install).

Where is my data stored?

Your backup data is stored on your local computer's hard drive, not in the cloud. The exact location depends on your operating system.

Can I turn it off temporarily?

Yes, you can disable it in Settings → System → Local Backup Server by turning off "Use Local Backup Server".

Troubleshooting

Connection Failed

If you see "Connection failed" when testing:

  1. Check if server is running:
    • Windows: Look for TrafficPOS icon in system tray
    • Linux: Check system tray or run ps aux | grep traffic
  2. Restart the server:
    • Windows: Double-click start-server.bat
    • Linux: Run systemctl --user restart trafficpos-backup
  3. Check Windows Firewall:

    Allow TrafficPOS Backup Server through firewall if prompted

Sync Not Working

If auto-sync isn't working:

  1. Verify "Auto-sync" is turned ON
  2. Check "Sync on Sale" is turned ON
  3. Try clicking "Sync Now" manually
  4. Check the browser console for errors (F12)

Best Practices

Daily Routine

Data Safety

Need Help?

If you encounter any issues:

  1. Check the troubleshooting section above
  2. Contact your IT administrator
  3. Reference the technical documentation
← Offline Mode Backup Guide →