Dify 무료 플랜은 지식 문서 50개, 저장공간 50MB에서 막힌다.
그 한도를 없애는 방법이 있다. 커뮤니티 에디션을 내 컴퓨터에 직접 설치하는 것이다. 오픈소스로 공개돼 있고 도커로 올린다.
대신 조건이 붙는다. 워크스페이스는 하나이고, Dify 오픈소스 라이선스를 따라야 하며, 서버는 내가 관리해야 한다.
내 컴퓨터가 감당하나
공식 문서가 요구하는 최소 사양은 CPU 2코어, 램 4GiB다. 다만 운영체제별로 따로 챙길 게 있다.
- macOS 10.14 이상 — Docker Desktop 과 Docker Compose 2.24.0 이상. 도커 가상머신에 최소 2 vCPU 와 8GiB 메모리를 할당하라고 문서가 명시한다
- 리눅스 — Docker 19.03 이상, Docker Compose 2.24.0 이상
- 윈도우 — WSL 2 를 켜야 한다
윈도우에서는 소스코드와 데이터를 윈도우 파일시스템이 아니라 리눅스 파일시스템에 두라고 문서가 못 박는다. 리눅스 컨테이너에 묶이는 파일이기 때문이다.
맥에서 눈여겨볼 건 8GiB다. 최소 사양은 램 4GiB인데, 맥은 도커 가상머신에 따로 8GiB를 주라고 적혀 있다. 기본값으로 두고 시작하면 모자랄 수 있다.
설치는 네 줄이다
순서는 이렇다.
- 최신 릴리스 태그로 소스를 클론한다 — git 이 없으면 command not found 가 뜬다
- dify/docker 디렉터리로 이동한다
- .env.example 을 .env 로 복사한다
- docker compose up -d 로 컨테이너를 띄운다
여기서 걸리기 쉬운 게 Compose 버전이다. Dify는 2.24.0 이상을 요구한다. docker compose version 으로 먼저 확인하는 게 낫다.
설정을 바꾸고 싶으면 나중에 .env 를 손보면 된다. 처음에는 예시 파일 그대로 복사해 시작하라는 게 문서의 안내다.
하나가 꺼져 있어도 정상이다
다 떴는지는 docker compose ps 로 본다. 코어 서비스 7개와 의존 컴포넌트 8개, 그리고 한 번만 도는 작업 1개가 올라온다.
api, worker_beat, plugin_daemon 같은 것이 앞의 것이고, weaviate, db_postgres, ssrf_proxy 같은 것이 뒤의 것이다.
init_permissions 가 Exited 상태인 것은 정상이다. 저장소 파일 권한을 설정하고 끝나면 스스로 종료되는 일회성 작업이라, 문서도 Exited 가 예상되는 상태라고 적어두었다. 이걸 실패로 보고 다시 까는 건 헛수고다.
나머지가 전부 Up이면 관리자 계정을 만들면 된다. 내 컴퓨터에 깔았으면 브라우저에서 localhost/install, 서버에 깔았으면 서버 주소 뒤에 /install 을 붙인다.
정리하면 이렇다. 얻는 건 문서 개수와 용량 한도가 사라지는 것이고, 잃는 건 서버를 직접 돌봐야 한다는 점이다.
그래서 순서는 클라우드로 먼저 만들어보고, 한도에 닿으면 그때 옮기는 쪽이 편하다. 처음부터 설치로 시작하면 챗봇을 만들기도 전에 도커와 씨름하게 된다..
Dify's free plan stops at 50 knowledge documents and 50MB of storage.
There is a way around that limit: install the Community Edition yourself. It is open source and runs with Docker.
The trade-offs are stated up front — a single workspace, the Dify open source license, and a server you maintain.
Can your machine handle it
The documented minimum is 2 CPU cores and 4 GiB of RAM. Each operating system adds something of its own.
- macOS 10.14 or later — Docker Desktop with Docker Compose 2.24.0+. The docs say to give the Docker virtual machine at least 2 virtual CPUs and 8 GiB of memory
- Linux — Docker 19.03+ and Docker Compose 2.24.0+
- Windows — WSL 2 must be enabled
On Windows the docs are explicit: store the source code and data in the Linux file system, not the Windows one, because those files are bound to Linux containers.
The number to watch on macOS is 8 GiB. The general minimum is 4 GiB of RAM, but the Docker VM itself is told to get 8 GiB. Leaving the default may not be enough.
Installation is four commands
The sequence goes like this.
- Clone the source at the latest release tag — without git you get a command not found error
- Move into the dify/docker directory
- Copy .env.example to .env
- Start the containers with docker compose up -d
The easiest thing to trip on is the Compose version. Dify requires 2.24.0 or later, so checking with docker compose version first saves time.
Configuration can wait. The documented path is to copy the example file as-is and customize later.
One container being down is fine
Check what came up with docker compose ps. Seven core services, eight dependent components and one run-once task start.
The first group includes things like api, worker_beat and plugin_daemon; the second includes weaviate, db_postgres and ssrf_proxy.
An Exited status for init_permissions is expected. It is a one-time task that sets storage file permissions and then exits on its own — the docs say so directly. Reinstalling because of it is wasted effort.
Once everything else shows Up, create the admin account: localhost/install in a browser for a local install, or your server address followed by /install.
The trade is straightforward. You lose the document and storage caps; you gain a server to look after.
Which is why the easier order is to build on the cloud version first and move once you hit the limit. Starting with the install means wrestling Docker before you ever build a chatbot..