Skip to the content
Know your tech before you buy it. Makers: get listed from $49/mo

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.

Open source

Free

Open source

Getting started

  1. Open the Zally project website
  2. Choose the web interface, CLI, or RESTful API
  3. Start the web UI, server, and database together with Docker Compose for local hosting
  4. Configure which server-side rules are enabled or disabled
  5. 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.