Upgrading Traccar

If you are running Traccar version 4.0 or later, you can upgrade directly to the latest release. If you are on an earlier version, please review the notes at the bottom of this page first.

Upgrade steps:

  1. Back up the database.
  2. Back up the traccar.xml configuration file (if you have modified it).
  3. Back up the media folder (if it exists).
  4. Uninstall the previous version of Traccar.
  5. Install the new version of Traccar.
  6. Restore the media folder (if applicable).
  7. Restore the traccar.xml configuration file (if applicable).
  8. Start the Traccar service.

If you are using versions 3.3-3.17, upgrade to version 4.0 first, and then to the latest release.

If you are using versions 3.0-3.2, upgrade to version 3.3 first, and then to the latest release.

If you are on version 2.x, you must migrate the database schema manually. See Upgrading from 2.x to 3.0 for details.

These instructions assume that only the main configuration file has been modified. If you have changed other files (for example, templates), re-apply those changes to the new version. Older templates may not be compatible with newer releases.