valkey-bundle

Valkey Bundle Docker Image

valkey-bundle镜像用于安装valkey服务器并加载所有valkey模块,提供集成了服务器与完整模块的一站式运行环境。

7 次收藏下载次数: 0状态:社区镜像维护者:valkey仓库类型:镜像最近更新:
下载命令
点击查看

This file is auto-generated by the Valkey Bundle Update workflow

Quick reference

  • Maintained by:
    https://github.com/valkey-io/valkey-bundle

  • Where to get help:
    Please open an issue stating your question at https://github.com/valkey-io/valkey-bundle/issues.

Supported tags and respective Dockerfile links

Official releases

  • https://github.com/valkey-io/valkey-bundle/blob/mainline/9.1/debian/Dockerfile
  • https://github.com/valkey-io/valkey-bundle/blob/mainline/9.1/alpine/Dockerfile
  • https://github.com/valkey-io/valkey-bundle/blob/mainline/9.0/debian/Dockerfile
  • https://github.com/valkey-io/valkey-bundle/blob/mainline/9.0/alpine/Dockerfile
  • https://github.com/valkey-io/valkey-bundle/blob/mainline/8.1/debian/Dockerfile
  • https://github.com/valkey-io/valkey-bundle/blob/mainline/8.1/alpine/Dockerfile

Release candidates

  • https://github.com/valkey-io/valkey-bundle/blob/mainline/9.2/debian/Dockerfile
  • https://github.com/valkey-io/valkey-bundle/blob/mainline/9.2/alpine/Dockerfile

Latest unstable

  • https://github.com/valkey-io/valkey-bundle/blob/mainline/unstable/debian/Dockerfile
  • https://github.com/valkey-io/valkey-bundle/blob/mainline/unstable/alpine/Dockerfile

What is https://github.com/valkey-io/valkey-bundle?


Valkey Bundle is a containerized version of Valkey, enhanced with popular modules like https://github.com/valkey-io/valkey-json, https://github.com/valkey-io/valkey-bloom, https://github.com/valkey-io/valkey-search, and https://github.com/valkey-io/valkey-ldap, allowing you to utilize advanced data structures and additional search capabilities alongside standard Valkey functionality.

This image is built on top of the official Valkey base image and simplifies deployment of Valkey with these powerful modules included.

Versions

valkey-bundlevalkeyvalkey-jsonvalkey-bloomvalkey-searchvalkey-ldap
unstableunstablehttps://github.com/valkey-io/valkey-json/tree/unstablehttps://github.com/valkey-io/valkey-bloom/tree/unstablehttps://github.com/valkey-io/valkey-search/tree/mainhttps://github.com/valkey-io/valkey-ldap/tree/main
9.2.0-rc2https://github.com/valkey-io/valkey/releases/tag/9.2.0-rc1https://github.com/valkey-io/valkey-json/releases/tag/1.0.3https://github.com/valkey-io/valkey-bloom/releases/tag/1.0.1https://github.com/valkey-io/valkey-search/releases/tag/1.3.0-rc1https://github.com/valkey-io/valkey-ldap/releases/tag/1.1.1
9.1.3https://github.com/valkey-io/valkey/releases/tag/9.1.2https://github.com/valkey-io/valkey-json/releases/tag/1.0.3https://github.com/valkey-io/valkey-bloom/releases/tag/1.0.1https://github.com/valkey-io/valkey-search/releases/tag/1.2.1https://github.com/valkey-io/valkey-ldap/releases/tag/1.1.1
9.0.6https://github.com/valkey-io/valkey/releases/tag/9.0.6https://github.com/valkey-io/valkey-json/releases/tag/1.0.3https://github.com/valkey-io/valkey-bloom/releases/tag/1.0.1https://github.com/valkey-io/valkey-search/releases/tag/1.0.3https://github.com/valkey-io/valkey-ldap/releases/tag/1.0.1
8.1.10https://github.com/valkey-io/valkey/releases/tag/8.1.10https://github.com/valkey-io/valkey-json/releases/tag/1.0.3https://github.com/valkey-io/valkey-bloom/releases/tag/1.0.1https://github.com/valkey-io/valkey-search/releases/tag/1.0.3https://github.com/valkey-io/valkey-ldap/releases/tag/1.0.1

Security

For ease of accessing Valkey Bundle from other containers via Docker networking, the "Protected mode" is turned off by default. This means if you expose the port externally (e.g., via -p), it will be open without authentication. It is strongly recommended to set a password or authentication method if exposing your instance to the internet.

See the following resources for securing Valkey:

  • https://valkey.io/topics/security/
  • https://valkey.io/topics/security/#protected-mode

How to use this image

Start a valkey-bundle instance

console
$ docker run --name my-valkey-bundle -d valkey/valkey-bundle

Start with persistent storage

console
$ docker run --name my-valkey-bundle -d valkey/valkey-bundle valkey-server --save 60 1 --loglevel warning

This example saves a snapshot every 60 seconds if at least one write occurred. Data is stored at VOLUME /data.

Connecting via valkey-cli

console
$ docker run -it --network some-network --rm valkey/valkey-bundle valkey-cli -h my-valkey-bundle

Pass additional start arguments with environment variable

You can configure startup arguments with the environment variable VALKEY_EXTRA_FLAGS:

console
$ docker run --env VALKEY_EXTRA_FLAGS='--save 60 1 --loglevel warning' valkey/valkey-bundle

Custom valkey.conf usage

Create a custom configuration file valkey.conf and use it in your container:

Dockerfile approach:

dockerfile
FROM valkey/valkey-bundle:latest
COPY valkey.conf /usr/local/etc/valkey/valkey.conf
CMD [ "valkey-server", "/usr/local/etc/valkey/valkey.conf" ]

Docker run approach:

console
$ docker run -v /myvalkey/conf:/usr/local/etc/valkey --name my-valkey-bundle valkey/valkey-bundle valkey-server /usr/local/etc/valkey/valkey.conf

Image Variants

valkey/valkey-bundle:<version>

This is the primary image, which includes Valkey along with common modules like valkey-json, valkey-bloom, valkey-search, and valkey-ldap preloaded. It is suitable for development, testing, and production environments where these modules are needed out of the box.

Some of the tags may include names like bookworm, which refer to https://wiki.debian.org/DebianReleases. These indicate the base image used and help ensure compatibility if your container needs additional packages. Specifying these explicitly is recommended to avoid unexpected changes when base image versions update.

If you want a minimal yet functional Valkey container with built-in modules, this image is a great place to start.

valkey/valkey-bundle:<version>-alpine

This image is based on the popular [***] available in https://hub.docker.com/_/alpine. Alpine Linux is much smaller than most distribution base images (~5MB), and thus leads to much slimmer images in general.

This variant is useful when final image size being as small as possible is your primary concern. The main caveat to note is that it does use https://musl.libc.org instead of https://www.etalabs.net/compare_libcs.html, so software will often run into issues depending on the depth of their libc requirements/assumptions. See this Hacker News comment thread for more discussion of the issues that might arise and some pro/con comparisons of using Alpine-based images.

To minimize image size, it's uncommon for additional related tools (such as git or bash) to be included in Alpine-based images. Using this image as a base, add the things you need in your own Dockerfile (see the https://hub.docker.com/_/alpine/ for examples of how to install packages if you are unfamiliar).

License

View the https://github.com/valkey-io/valkey-bundle/blob/mainline/LICENSE for software included in this image.

Users of this image are responsible for ensuring compliance with all licenses of software contained within.

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本,请访问 标签列表页面。

轩辕镜像加速拉取命令点我查看更多 valkey-bundle 镜像标签

docker pull docker.xuanyuan.run/valkey/valkey-bundle:<标签>

DockerHub 原生拉取命令

docker pull valkey/valkey-bundle:<标签>
专业版 · 高速稳定拉取镜像
50GB 仅 ¥8/年
高速镜像下载在线技术支持专业版保障服务可用付费会员免广告