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:
even for non--sqlite versions the latest Dockerhub-published version is v0.12.0 whereas the latest release is v0.13.0 (means you don't automatically publish a new docker image with every release)
the contrib folder hasn't been updated for a while: the relation-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=true argument that is required in newer versions of the keto CLI (same holds true for all the CLI commands mentioned in the Quickstart).
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
Preflight checklist
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-setmax_depth
). Updating the version yourself easily is made difficult by the following factors:docker-compose
of thecat-videos-example
has a-sqlite
suffix; on Dockerhub there is no no-sqlite
version later thanv0.8.0
-sqlite
versions the latest Dockerhub-published version isv0.12.0
whereas the latest release isv0.13.0
(means you don't automatically publish a new docker image with every release)contrib
folder 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)--insecure-disable-transport-security=true
argument 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 thebuild
make target and just needed to update the folders in thedocker-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
Workarounds or alternatives
Does not apply.
Version
v0.13.0
Additional Context
No response