Dify

Dify 설치 : contains unsupported option: 'required' 오류가 발생하는 경우

비공식 Docker 설치로 인한 option: 'required' 오류
종상
종상
Dec 08, 2025
Dify 설치 : contains unsupported option: 'required' 오류가 발생하는 경우
Contents
unsupported option: 'required' 에러 발생기존 도커 삭제 (선택)공식 Docker engine 설치업데이트 또는 설치 진행

안녕하세요

최근에 React, Next.js CVE 취약점이 발생해 Dify Community Edition 버젼이 v1.10.1로 업데이트되었습니다.
(Enterprise는 v3.6.2로 업데이트되었습니다.)

따라서 업데이트나 (재)설치를 진행하시는 분들이 계실 것으로 생각됩니다.

  • Dify 설치 과정에 아래와 같은 발생해요

  • 구버젼 설치할 때는 오류가 없었는데 이번 설치 과정에서 에러가 발생해요

  • 업데이트하려니 오류가 발생합니다.
     

unsupported option: 'required' 에러 발생

services.api.depends_on contains unsupported option: 'required'
services.worker.depends_on contains unsupported option: 'required'
services.worker_beat.depends_on contains unsupported option: 'required'
services.plugin_daemon.depends_on contains unsupported option: 'required'

비공식 Docker engine과 Plugin 패키지를 사용하는 경우 이런 에러가 발생할 수 있습니다.
Dify 설치나 업데이트 과정에서 이런 에러가 발생한다면 아래의 내용을 따라 해 보세요.

기존 도커 삭제 (선택)

비공식 도커의 종류는 아래와 같습니다.

  • docker.io

  • docker-compose

  • docker-compose-v2

  • docker-doc

  • podman-docker

삭제 명령어

sudo apt remove $(dpkg --get-selections docker.io docker-compose docker-compose-v2 docker-doc podman-docker containerd runc | cut -f1)

주의 : 실행 중인 도커 컨테이너가 있는 경우 백업 및 종료 후 삭제해야 합니다.

공식 Docker engine 설치

  1. Docker repository 설정하기

    # Add Docker's official GPG key:
sudo apt update
sudo apt install ca-certificates curl
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc

# Add the repository to Apt sources:
sudo tee /etc/apt/sources.list.d/docker.sources <<EOF
Types: deb
URIs: https://download.docker.com/linux/ubuntu
Suites: $(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}")
Components: stable
Signed-By: /etc/apt/keyrings/docker.asc
EOF

sudo apt update

  1. Docker 패키지 설치

    sudo apt install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

업데이트 또는 설치 진행

Dify 설치 : 최신버젼으로 업데이트하는 방법

https://blog.open-network.co.kr/dify-install-latest-update

Docker 공식 패키지를 설치하였으니 다시 시도해 보시면 기존 에러는 발생하지 않고 잘 진행이 될 것입니다.

감사합니다.

문의가 필요하신 경우 아래의 링크로 자유롭게 문의 부탁드립니다.

오픈소스 문의: https://discord.com/invite/FngNHpbcY7
엔터프라이즈 도입 문의: ai@open-network.co.kr

Share article