v0.22 Migration

v0.22 Migration

v0.22 tightens command boundaries and removes old pre-rename migration helpers. Most users only need to update scripts that still run bare kei.

kei sync is required

Running kei without a subcommand now prints top-level help. It no longer starts a sync.

Change scripts and cron jobs like this:

# Old
kei --config ~/.config/kei/config.toml

# New
kei sync --config ~/.config/kei/config.toml

Sync-only flags such as --dry-run, --recent, --only-print-filenames, and --retry-failed belong under kei sync. kei service run still accepts sync settings for service and Docker worker mode.

Old credential migration was removed

Encrypted-file credentials now use .kei-state directly. The old .credential-key auto-rename path is gone.

If you still have a pre-0.6.2 .credential-key file, rename it to .kei-state yourself before using the encrypted-file backend.

Old icloudpd-rs path migration was removed

Startup no longer auto-copies config, cookies, or state from old icloudpd-rs paths. If you still depend on those files, copy the needed files into ~/.config/kei or the container /config volume before starting v0.22.

State database

The state database migrates automatically to schema v15. The new migrations are additive and keep existing download history.

See State Tracking for the schema version list.