ONS
도입하기
  • AI 인프라Dell Pro MaxOrcai SMS
  • AI 솔루션DifyAX Foundry
  • 블로그블로그
  • 회사소개소개연혁
AI 인프라
  • Dell Pro Max
    Dell Pro Max
  • Orcai SMS
    서버 모니터링 솔루션
AI 솔루션
  • Dify
    노코드 AI 앱 빌더
  • AX Foundry
    AI 전환을 위한 인사이트
블로그
  • 블로그
    트렌드와 인사이트
회사소개
  • 소개
    27년 인프라 전문기업
  • 연혁
    27년간의 연혁
Dify

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

비공식 Docker 설치로 인한 option: 'required' 오류
종상's avatar
종상
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
Contents
unsupported option: 'required' 에러 발생기존 도커 삭제 (선택)공식 Docker engine 설치업데이트 또는 설치 진행
logo

(주)오픈네트웍시스템

경기도 의왕시 이미로 40, B동 907호 (포일동, 인덕원IT밸리)

사업자등록번호. 107-81-69444

대표이사. 박봉균

문의

ai@open-network.co.kr
📞 031-1544-0357
개인정보 처리방침
© OPEN NETWORK SYSTEM CO., LTD. All rights reserved.