RBTERP

Guides › Upgrading RBTERP Safely

Upgrading RBTERP Safely

RBTERP team · · 3 min read

How to prepare for a new RBTERP release, install it on the desktop, check that it worked, and what to do if an upgrade stops part way.

RBTERP Business Dashboard screen: Your whole business on one screen

Business Dashboard in RBTERP, with a sample company and fictional data.

New releases bring fixes and features, and sometimes changes to how your data is stored. An upgrade is routine, but it touches every record you have, so it deserves a little preparation. Twenty minutes of care before an upgrade is worth far more than a day of recovery after one.

Choose the moment

Read the release notes we send with the installer first. They say what changes and whether anything needs your attention.

Before the upgrade

Take a protected backup with a label and passphrase, then check it, before upgrading
Take a protected backup with a label and passphrase, then check it, before upgrading
  1. Note where you are. Under Settings, then Support, *About this installation* shows the product version and the schema: the version of your data's structure. Write both down.
  2. Take a protected backup. Under Settings, then Backup and Restore, take a backup with a label such as "before November release", and protect it with a passphrase.
  3. Check that backup. It must show *Passes every check*. A backup that does not pass is not a starting point: free some disk space and take it again.
  4. Copy it off the computer to storage only administrators can read.
  5. Ask everyone to sign out, including any staff working over the office network.

Upgrading the desktop

  1. Close RBTERP.
  2. Run the new release's installer over the existing installation. Your data folder is kept.
  3. Start RBTERP and sign in.
  4. Open Settings, then Support, and read *About this installation*.
  5. Open Settings, then Backup and Restore. You should see a backup named with *before-upgrade*.

What RBTERP does by itself

When a new release starts on older data, it protects you before it changes anything:

  1. It reads where your data stands.
  2. If the data is behind the new release, it takes a pre-upgrade backup and checks it before making any change.
  3. It brings the data's structure up to date, one recorded step at a time.
  4. A second start does nothing further.

If that pre-upgrade backup cannot be taken, nothing is changed and RBTERP refuses to work until the problem is fixed, rather than carrying on without a safety net. Note that the automatic pre-upgrade backup on the desktop holds the database only, not attachments, which is why your own protected backup in the preparation step matters.

Checking the result

About this installation: the product, the schema, and Up to date
About this installation: the product, the schema, and Up to date

If an upgrade stops

You may see a red Upgrade stopped banner under Settings, then Support, or screens saying the upgrade did not start or a step failed. In that state only backups, the version screen and sign-in work. The message names the cause and, where relevant, the backup to restore. Follow it, or contact us with the exact message before trying anything else.

Some upgrades check your data first and stop with a list of records that must be tidied, without changing anything. Fix what it names and start again.

Keep the old backups

Keep at least the backup from before each upgrade until you are confident in the new release, usually a full month-end later. Backups from earlier releases can still be checked and restored. See how to back up your accounting data.

Our Software Update service does all of this for you: a backup before the upgrade, the upgrade itself, and a balance check before and after.

More guides

Approvals and Workflows: Who Signs Off What

How to design approval rules for purchases, payments and other documents: approval levels, amount limits, delegation, escalation and maker-checker.

16 November 2026 · 3 min read

See RBTERP working with your own business

Pick a plan and request it, or tell us about your company and we will help you choose.