Skip to main content

How to install Weaviate

Weaviate is available as a hosted service, Weaviate Cloud (WCD), or as a self managed instance. If you manage your own instance, you can host it locally or with a cloud provider. Self-managed instances use the same Weaviate core database as WCS.

Installation methods

To install and configure Weaviate, see the following:

Configuration files

Docker Compose and Kubernetes use yaml files to configure Weaviate instances. Docker uses the docker-compose.yml file. Kubernetes relies on Helm charts and the values.yaml file. The Weaviate documentation also calls these files configuration yaml files.

If you are self-hosting, consider experimenting on a small scale with Docker and then transferring your configuration to Kubernetes Helm charts when you are more familiar with Weaviate.

Unreleased versions

Unreleased software

DISCLAIMER: Release candidate images and other unreleased software are not supported.

Unreleased software and images may contain bugs. APIs may change. Features under development may be withdrawn or modified. Do not use unreleased software in production.

To run an unreleased version of Weaviate, edit your configuration file to use the unreleased image instead of a generally available image. The GitHub releases page lists generally available and release candidate builds.

For example, to run a Docker image for a release candidate, edit your docker-config.yaml to import the release candidate image.


When try out upcoming features, please provide feedback. Your comments are appreciated and help us to make Weaviate more useful for you.

Questions and feedback

If you have any questions or feedback, let us know in the user forum.