Update

Click me to check new updates

You have already downloaded HorizonGram but would like to upgrade it to the latest version. Well, re-installing from scratch is not a good option since creating a new bot and chat archive would mean losing the files saved in the cloud. Therefore, there is a simple procedure to follow in general. For certain updates (named "breaking changes updates"), however, specific procedures will be listed.

Generic update

Suppose you are using version X and want to upgrade to Y.
Suppose you checked the list of breaking changes updates and there is no version Z that falls in the list and that is X < Z ≤ Y.

  1. Extract the Y version to a temporary folder
  2. Copy all files and folders except server from the temporary folder where you extracted update Y to the HorizonGram version X folder
  3. Open the server folder in Y and X HorizonGram folders
  4. Copy all files from server Y folder to server X folder (this prevents the .env file from being overwritten or deleted)
Breaking changes updates

Suppose you are using version X and want to upgrade to Y.
Suppose you checked the list of breaking changes updates and there is one or more version Z that falls in the list and that is X < Z ≤ Y.
You must first execute in order all the updates present between version X and version Y listed in the breaking changes updates.

Example: you have installed version 2 and want to upgrade to version 8. In the update list of breaking changes updated there is version 6.
You must upgrade to version 6 by following the appropriate section in the breaking changes updates, then you can upgrade to version 8 by following the generic procedure.

Breaking changes updates

Version 2

This new version introduces a new way of managing configurations for file handling. Before version 2, it was necessary to create a .env file containing secret values required by the application to interact with Telegram and the metadata database (Firebase Realtime Database). This version introduces multiple profiles, allowing you to register multiple sets of secret values, thereby enabling the use of multiple cloud spaces. Having multiple cloud spaces also means the ability to share them, so anyone can create shared spaces and, consequently, share their content as well.

How to upgrade
  1. Extract the version 2 to a temporary folder
  2. Copy all files and folders including the server folder to the actual HorizonGram version folder
  3. Open the server/settings folder
  4. Duplicate config-template.json and rename the copy to config.json
  5. Edit config.json following the server setup guide