Zally
opensource.zalando.com
- Free plan
- Windows
- macOS
- Linux
- Web
- API
- Self-hosted
What Zally is
Zally is an API linter and quality assurance tool for OpenAPI specifications. It supports OpenAPI 3 and Swagger OpenAPI 2, and offers a RESTful API, command-line interface, and web interface. Its standard setup checks APIs against Zalando’s RESTful Guidelines, while the project says others can use it out of the box. Teams can enable or disable server-side rules, configure some existing rules, or write custom rules in Kotlin. An API definition can use the x-zally-ignore extension to exempt itself from rules. The web interface lists implemented rules and can lint external files and API definitions in its online editor. The README describes starting the web UI, server, and database together with Docker Compose for local use. It also lists an unofficial Maven Plugin integration. Zally is maintained by Zalando and offered under an MIT license with an exception. The project invites users to its Gitter room or to contact maintainers for support, and its security policy provides a route for vulnerability reports through Zalando’s form.
Who it suits
Zally suits teams that want to check OpenAPI descriptions against API style rules through a CLI, web interface, or RESTful API. It also fits teams prepared to configure rules or implement additions in Kotlin.
Good to know, and what to watch
- Supports OpenAPI 3 and Swagger OpenAPI 2.
- Provides RESTful API, CLI, and web interfaces.
- Rules can be configured or implemented in Kotlin.
- Web editor can lint external files and API definitions.
- Docker Compose setup includes the UI, server, and database.
- Custom rules are implemented in Kotlin.
- The listed Maven Plugin integration is unofficial.
- The license includes an exception.
Plans
Every plan and priceOpen source
Open source
Getting started
- Open the Zally project website
- Choose the web interface, CLI, or RESTful API
- Start the web UI, server, and database together with Docker Compose for local hosting
- Configure which server-side rules are enabled or disabled
- Lint OpenAPI 2 or OpenAPI 3 files and definitions
The verdict
Zally brings OpenAPI linting and configurable style rules to a free project with several ways to use it. It is a practical option for teams whose specifications use supported formats and whose rule needs fit its configuration model.
Questions people ask
Is Zally free?
Yes. Zally has an open-source plan priced at no cost and is offered under an MIT license with an exception.
Which API formats does Zally support?
It supports OpenAPI 3 and Swagger OpenAPI 2 specifications.
Can Zally run locally?
Yes. The project describes starting the web UI, server, and database together with Docker Compose.
Can its rules be customized?
Users can enable or disable server-side rules, configure some existing rules, write custom rules in Kotlin, and use x-zally-ignore in an API definition.
Who maintains Zally?
Zally is maintained by Zalando.
What the maker publishes
- Customization
- Users can enable or disable server-side rules, configure some existing rules, and implement custom rules in Kotlin. source
- Guidelines
- Its standard configuration checks APIs against Zalando’s RESTful Guidelines, and the project says it can also be used out of the box by others. source
- Integration
- The README lists a Zally Maven Plugin integration and labels it unofficial. source
- Integrations
- The README lists an unofficial Zally Maven Plugin integration. source
- Interfaces
- Zally provides a RESTful API, a CLI, and a web interface. source
- License
- The project is offered under an MIT license with an exception. source
- Local deployment
- The project README says the web UI, server, and database can be started together with Docker Compose. source
- Maintainer
- The project site says Zally is maintained by Zalando. source
- Maker
- The project says it is maintained by Zalando. source
- OpenAPI support
- It supports OpenAPI 3 and Swagger OpenAPI 2 specifications. source
- Platforms
- The release page lists Zally CLI downloads for Linux, macOS, and Windows. source
- Purpose
- Zally is an API linter and quality assurance tool for OpenAPI specifications. source
- Rule exceptions
- The x-zally-ignore extension lets an API definition disable rules for that API. source
- Rule exceptions
- The x-zally-ignore extension lets users disable rules for a specific API. source
- Security
- The repository has a security policy page, but the opened policy page did not expose its policy text. source
- Security reporting
- The repository security policy says vulnerability reports can be submitted through Zalando’s form and that its HackerOne bug bounty program is private. source
- Self-hosting
- The README describes running the web UI, server, and database together with Docker Compose. source
- Specification support
- It supports OpenAPI 3 and Swagger OpenAPI 2 specifications. source
- Support
- The project invites users to join its Gitter room or contact maintainers directly. source
- Web UI
- The web UI lists implemented rules and can lint external files and API definitions in its online editor. source
Checked against the maker's pages on 8 Oct 2026.