We are happy to announce that Gancio v2.0 now has a nice API documentation which you can find in the Hacking > API section.

All data endpoints are available with its description, needed parameters and responses you will get. It is specified if authentication is required or not, as well.

Moreover, you can enter your input data and get on the fly the request (with cURL, Javascript, PHP and Python).
In addition, you can test it directly at demo.gancio.org clicking Try it out button.

Technically, to generate this documentation we are using swagger-jsdoc and vitepress-openapi.

You are invited to use and test it, and if you want to collaborate adding more examples, improving the documentation or fixing a bug, don’t hesitate to collaborate.

It’s been quite a while, but we’ve finally reached a point where we can wrap things up and release a beta. We think it’s a good starting point for setting up new instances, but not quite ready for updating existing ones yet. Of course, if you want to give it a try, that’s great, let us know how it goes 😄

“OK, but how do I try it out?”

The easiest way is to use the demo instance. For those who want to compare, we’ve kept the old demo instance at https://legacy.gancio.org.

If you’d rather install a new instance, you can choose to install it via Docker, Podman, or directly via npm.

I’d like to thank all the contributors, this release wouldn’t have been possible without your invaluable help, from translations (we’re now in over 40 languages) to countless suggestions, testing, bug reports, and chats, but especially the code contributions: especially @germanfr, who made most of the improvements you’ll appreciate and which we’ll tell you about soon, and also @tina, @monica, and @sim6, who are giving me a big hand in bringing some structure and order to my mess, thanks also to nlnet’s contribution.