Apply upgrades

Follow this guide when upgrading Ory Keto to a newer version.

danger

Back up your data! Applying upgrades can lead to data loss if handled incorrectly.

1. Review breaking changes. Visit the CHANGELOG.md to see if breaking changes have been introduced in the version you are upgrading to.
2. Backup your data.
3. Update the Ory Keto SDK if used in your application.
4. Install the new version of Ory Keto.
5. Run keto migrate to run the SQL migrations to the new database schema.

Should you run into problems with the upgrade, consider a stepped upgrade and please visit the community chat or start a discussion.

Migrating to Keto 0.7

Ory Keto v0.6 used the table-separated namespaces database schema described in the Google Zanzibar paper. However, we found for various reasons outlined in that this isn't ideal for Keto. Visit migrating to Keto v0.7 guide for more information

Migrating Keto policies from 0.5 version

In Ory Keto 0.6 Ory Access Control Policy DSL modeled after AWS IAM Policies became obsolete. Visit migrating legacy policies guide for more information.