During the upgrade, migration, or recreation of Skedler VM or container, you can persist the license key and also the data from your existing Skedler v5 installation and reuse them in the new Skedler v5 environment.  

License Persistence

To avoid manual activation of Skedler v5 license after upgrade or migration, uncomment the following keys and add the email id and license key to the reporting.yml file.  Skedler will automatically activate the license during the start.  

  • licenseKey - A valid Skedler reports license key.
  • licenseEmail - A valid email id that you had used in your initial activation of the Skedler Reports

Skedler will automatically reactivate the license during the start.  

Data Persistence

To persist Skedler data and configuration, you need to persist the following:

  1. reporting.yml
  2. Skedler database
  3. Asset files
  4. Log files (this is optional)

Please find below detailed information on each of the above components:

  • reporting.yml -  This contains the configuration information for Skedler.  The location for reporting.yml is given below for various install packages:
    • .tar.gz : $skedler-xg/reporting.yml (skedler-xg home directory)
    • .deb and .rpm : /usr/share/skedler-xg/reporting.yml
  • Skedler database- By default Skedler uses SQLite as the internal database.  The SQlite database is located in the following location which must be persisted:  
    • Linux:  /var/lib/skedler-xg
    • Windows: c:/skedler-xg-system-files

            The databasePath parameter in reporting.yml can be customized to modify the location of the database.  


            Optionally, you can use an external MySQL instance as the database for Skedler.   If you use an external MySQL instance,  then you can ignore the database persistence requirement. 

  • Asset files- Asset files consist of images and JSON files that are used for rendering reports.  The asset files are located in
    • Linux:  /var/lib/skedler-xg
    • Windows: c:/skedler-xg-system-files
  • Log files - Persisting log files is optional.  The logFilesDir parameter in reporting.yml can be customized to modify the location of log files. The default location for log files is given below:
    • Linux: /var/opt/skedler-xg
    • Windows: c:/skedler-xg-system-files