Volume Mount icon Volume Mount

OVERVIEW

Created by

Kestra Core Team

Managed by

Kestra Core Team
Table of Contents

Volume Mount

How to migrate volume-enabled to the plugin configuration.

The docker volume mount, by setting the property kestra.tasks.scripts.docker.volume-enabled to true, has been deprecated since 0.17.0. It is now recommended to use the plugin configuration volume-enabled for the Docker runner plugin.

This change is implemented in a non-breaking way, so you don’t need to immediately change the way you use the docker volume mount. In case you use this older method for mounting the volume, you will receive the following deprecation warning:

It is recommended to make the following change in the Docker Compose file for mounting the volume:

 kestra:
    image: kestra/kestra:latest
    pull_policy: always
    user: "root"
    env_file:
      - .env
    command: server standalone --worker-thread=128
    volumes:
      - kestra-data:/app/storage
      - /var/run/docker.sock:/var/run/docker.sock
      - /tmp/kestra-wd:/tmp/kestra-wd:rw
    environment:
      KESTRA_CONFIGURATION: |
        datasources:
          postgres:
            url: jdbc:postgresql://postgres:5432/kestra
            driver-class-name: org.postgresql.Driver
            username: kestra
            password: k3str4
        kestra:
          server:
            basic-auth:
              enabled: false
              username: "admin@kestra.io" # it must be a valid email address
              password: kestra
          repository:
            type: postgres
          storage:
            type: local
            local:
              base-path: "/app/storage"
          queue:
            type: postgres
          tasks:
            tmp-dir:
              path: /tmp/kestra-wd/tmp
          plugins:
            configurations:
              - type: io.kestra.plugin.scripts.runner.docker.Docker
                values:
                  volume-enabled: true # 👈 this is the relevant setting

For more information, you can refer the Bind mount page.

Was this page helpful?