Updating CICADA

You update CICADA by uploading a signed update file in the web interface.

Get the update file

1. Sign in at cicada-ir.ai/account (see Your account).
2. Choose the file for your appliance's architecture:
   • x86_64 for the OVA, QCOW2, VHDX and Proxmox appliances. The file is named cicada-update-<version>-x86_64.cup.
   • aarch64 for Apple Silicon. The file is named cicada-update-<version>-aarch64.cup.
3. Settings > Updates in CICADA shows your appliance's architecture next to the installed version.
4. Check the SHA-256 shown next to the file against your download.

Install it

1. In CICADA, go to Settings > Updates.
2. Upload the file.
3. Press Install. You need your password and authenticator code.

Appliances older than 1.84.24 cannot install update files. Install the new image and restore a backup instead.

What happens during the install

The appliance does these steps in order:

1. Checks the vendor signature.
2. Unpacks and tests the new version.
3. Stops CICADA.
4. Saves a snapshot of its data.
5. Switches to the new version.
6. Starts the new version and checks it is healthy.

CICADA restarts during this. The page keeps checking until it is back.

If the new version does not start

Within five minutes the appliance switches back to the previous version and its data on its own. Settings > Updates says that this happened.

If an update is held, see Troubleshooting.