Haystack Python Installation Guide | Restackio

To deploy Haystack using Docker, you start with the basic Docker container, which allows for a straightforward setup of your Haystack pipelines. The official Docker image for Haystack is available at deepset/haystack. This image comes in various flavors, tailored to different components and versions of Haystack.

Running Haystack in Docker

The simplest way to run Haystack is through Docker containers. Familiarizing yourself with the Haystack Docker images is essential for more advanced deployments. Currently, the only flavor available for Haystack 2.0 is base, which provides the same functionality as installing Haystack locally with pip install haystack-ai.

To pull a specific version of Haystack, you can use Docker tags. For instance, to pull the image for Haystack 2.0.0-beta7, execute the following command:

docker pull deepset/haystack:base-v2.0.0-beta.7

The base flavor is designed for customization but can also be used to run Haystack scripts locally without setting up a Python environment. For example, to print the version of Haystack running in a Docker container, use:

docker run -it --rm deepset/haystack:base-v2.0.0-beta.7 python -c "from haystack.version import __version__; print(__version__)"

Customizing the Haystack Docker Image

Most applications will require more than just the basic setup. You may need to install additional dependencies within the Docker image alongside Haystack. For instance, if you want to run an indexing pipeline using Chroma as your Document Store, you will need to install the chroma-haystack package.

To create a custom Docker image that includes this dependency, your Dockerfile should look like this:

FROM deepset/haystack:base-v2.0.0-beta.7

RUN pip install chroma-haystack

COPY ./main.py /usr/src/myapp/main.py

ENTRYPOINT ["python", "/usr/src/myapp/main.py"]

After setting up your Dockerfile, build your custom Haystack image with the following command:

docker build . -t my-haystack-image

This approach allows you to tailor your Haystack deployment to meet the specific needs of your application, ensuring that all necessary components are included and configured correctly.