Update from Version 2.0.16 to 2.2.1 - config import not possible

  • Hi All,

    Is it possible to edit a v. 2.0.16 config to enable the migration to v2.2.1?
    I want to move and update the hyperion installation to a new LXC in proxmox but the migration is only possible with backups coming from v2.0.17 and newer.
    I haven't seen something in the breaking changes on github.

    Brave AI mentions this workaround:
    Based on the available context, the recommended workaround for transferring configurations between incompatible versions is:

    • Database File Replacement: If you have access to the old system running 2.0.16, stop Hyperion on both machines, locate the configuration database file (typically named hyperion.db on Windows/Linux), and copy it from the old system to the new system running 2.2.1.
    • Export/Import via Intermediate Version: Alternatively, install version 2.1.1 on the old system, export the configuration from there, and then import it into the new system. Note that even this method may not preserve all settings perfectly, as users have reported issues with LED device stability (such as flickering WLED strips) after migration.
    • Manual Reconfiguration: For complex setups involving multiple LED devices (e.g., WLED), manual reconfiguration may be necessary to ensure stability, as known issues with grabbers and LED devices in newer versions can cause devices to fail to initialize correctly after a migration.

    I have attached the config backup of both instances.
    I use PiCap and WLED devices.

    Or is it recommended to re-config from scratch?

    I'd be glad if, someone could point me to the right post/article. Don't need a step-by-step guide. I don't want to waste anybodies time!!

    Thank you

    • Best Answer
    • Official Post

    It is exactly as the AI advised.
    Best would be you install the latest version on the original platform. Then start hyperion and you can export.

    Alternatively, you can install 2.2.1 on the new system, start and stop it.
    Then you can replace the database file with the one from the old system.


    As a courtesy, find attached your two exported 2.0.16 configs in a single 2.2.1config file.
    Please remove the ".txt" suffix before importing.

    You might need to change the instance names after import....

    PS: I added a Breaking-Change note with release 2.1.1 to make it more explicit.

  • Bub4 May 14, 2026 at 4:50 PM

    Selected a post as the best answer.
  • Thank you Lord-Grey !
    What a relief. I appreciate your help and the consolidation of my configs very much.
    Guess I have to trust AI a little more in the future.

    Upgrading and the migration seemed to work flawlessly. I am looking forward to latest version of Hyperion tonight.
    Costa Rica 4k on youtube looked amazing.

Participate now!

Don’t have an account yet? Register yourself now and be a part of our community!