Update FECForge without risking venue data

These instructions describe FECForge 1.32.35. If a control is missing, check your role and installed version before continuing.

1. Prepare your account and source information

   Sign in as owner and arrange a quiet update window. Confirm a completed backup on storage outside the application’s data directory.

1. Choose storage outside the container

   Use a host folder, mounted drive, or network location that will survive replacing the application container.

2. Pick the backup folder

   As the installation owner, open Settings → Data backups, choose a storage location, then Browse folders. Select an existing folder or create one. Save settings. Changing folders leaves previous backups where they are.

3. Confirm FECForge can write there

   Use the backup settings screen to run a manual backup and confirm the completed file is visible at the destination.

4. Keep more than one generation

   Schedule recurring backups and retain several recent copies so a bad import or late-discovered mistake can be recovered.

If a folder is missing from the picker, Docker may not have access to it. Mount the share on the server first. The following updater option attaches your chosen existing folder; no customer-specific programming is needed.

1. Download the current updater

   Run this first so the folder-selection option is available.

   curl -fsSLo /tmp/fecforge-update.sh https://license.fecforge.com/updater

   Copy command
2. Attach your existing backup folder during the update

   Replace the example path with your own mounted server folder. Keep the quotes if its name contains spaces. Existing backup files remain in their old folder.

   bash /tmp/fecforge-update.sh --backup-dir "/mnt/nas/Backups"

   Copy command
3. Choose a folder and verify a copy

   Return to Settings → Data backups → External backup storage → Browse folders. Select or create the desired subfolder, save, and run a backup. Confirm the copy exists on the backup device. Future updates preserve the attached location.

Download a fresh copy of the updater so fixes to the update process are included. Run one command at a time.

1. Download the current updater

   Paste this command and press Enter.

   curl -fsSLo /tmp/fecforge-update.sh https://license.fecforge.com/updater

   Copy command
2. Run the updater

   Paste this command and press Enter. Wait for the healthy result before closing the terminal.

   bash /tmp/fecforge-update.sh

   Copy command
3. Read the backup path in the result

   A successful update reports the verified version, health address, automatic-backup destination, and pre-update data archive.

4. Open FECForge and confirm the version

   Sign in, open License & modules, and verify that the expected version and modules appear.

5. Keep the prior container briefly

   The stopped pre-update container is a rollback aid. Remove older stopped FECForge containers only after the new version and data are confirmed.

1. Open License & modules after the update.

   The expected version and existing modules should appear. Open a known record and check the most recent backup status before resuming work.

2. If the result is not what you expected

   If records appear missing, stop entering data and retain both old and new backup generations. Ask support before restoring; restoring an older backup can replace newer work. Hosted Party Bookings and local records have separate backup responsibilities.