How to upgrade the server to newer version?

On Windows, if you are using .msi version

Download the new .msi file and run. Setup will upgrade the server.

Other platforms (or if you are using .zip on Windows)

  1. Stop ManicTime server

    • On Windows, if running as a service
      Open command prompt where ManicTimeServer.exe is (usually in "C:\Program Files\ManicTime Server") and type:

        ManicTimeServer stop
      
    • On Windows without a service, or on Linux
      Stop the ManicTimeServer process.

  2. Back up the data and configuration. For SQLite, copy ManicTimeCore.db from the server's data folder while the server is stopped. For PostgreSQL or Microsoft SQL Server, make a database backup with that database's backup tools. Also keep a copy of the server data folder and ManicTimeServerSettings.json before replacing application files. The reports database can be rebuilt from the core database.

  3. Delete old files - Delete all files in the folder where ManicTimeServer.exe is located, EXCEPT:

    • Data sub-folder
    • ManicTimeServerSettings.json, if it is in this folder (the default Windows location is C:\ProgramData\ManicTime\Server)

    Delete everything else.

  4. Copy new files - Download the latest version of ManicTime Server and copy the files from the downloaded archive (.zip on Windows or .tar.gz on Linux) into the installation folder.

  5. Start ManicTime server Then start the server again:

    • On Windows, if running as a service
      Open command prompt where ManicTimeServer.exe is (usually in "C:\Program Files\ManicTime Server") and type:

        ManicTimeServer start
      
    • On Windows without a service, or on Linux
      Start the ManicTimeServer process.

While upgrading the server all ManicTimes which connect to the server can continue running.

If you experience problems while trying to start the server after an upgrade, there are logs in /Data/Logs folder. You can check the logs to see if you can resolve the issue, or you can send us the logs and we can help fix it.