Keto Quickstart is outdated
Preflight checklist
- [X] I could not find a solution in the existing issues, docs, nor discussions.
- [X] I agree to follow this project's Code of Conduct.
- [X] I have read and am following this repository's Contribution Guidelines.
- [ ] I have joined the Ory Community Slack.
- [ ] I am signed up to the Ory Security Patch Newsletter.
Ory Network Project
No response
Describe your problem
The Keto Quickstart is based on keto v0.7.0-alpha.1. This is confusing because the instance started by this is not consistent with the API docs that assume the latest keto version (for example, regarding the handling of a non-set max_depth). Updating the version yourself easily is made difficult by the following factors:
- the Docker image used in the
docker-composeof thecat-videos-examplehas a-sqlitesuffix; on Dockerhub there is no no-sqliteversion later thanv0.8.0 - even for non-
-sqliteversions the latest Dockerhub-published version isv0.12.0whereas the latest release isv0.13.0(means you don't automatically publish a new docker image with every release) - the
contribfolder hasn't been updated for a while: therelation-tuples/*.json contain a"$schema": "../../../.schema/relation_tuple.schema.json",line that doesn't seem to be supported by more recent version of keto (if I am mistaken, please answer here and I'll update this issue accordingly) - the docker-compose.yml's init container command lacks the
--insecure-disable-transport-security=trueargument that is required in newer versions of the keto CLI (same holds true for all the CLI commands mentioned in theQuickstart).
After some research I could find out that I can actually use the project's Dockerfile-build via the build make target and just needed to update the folders in the docker-compose.yaml from /home/ory to /home/nonroot. Putting together all these pieces I was able to run a current version of keto via docker.
It would be nice if you could update both the examples and the Quickstart guide. In any case, I hope this issue might help other newcomers who run into the same problems when trying to run a recent version of keto.
Describe your ideal solution
- Quickstart is updated to the latest keto version
- docker hub images are kept up-to-date with new releases
Workarounds or alternatives
Does not apply.
Version
v0.13.0
Additional Context
No response