DMSF Plugin 은 레드마인의 기본 문서 관리 시스템(Document Management System) 모듈을 대체하는 플러그인이다.
Redmine은 기본적으로 문서 관리 기능을 제공하지만, 프로젝트 환경에서 실질적으로 필요한 문서 버전 관리, 폴더 기반 구조화, 이메일 전송, 파일 잠금, 워크플로우 기반 승인 프로세스 등은 부족하다.
DMSF (Document Management System Features) Plugin은 이러한 Redmine 기본 기능을 완전히 확장하는 대표적인 문서 관리 플러그인이다.
이 문서에서는 Synology NAS + Docker 기반 Redmine 6.1.0 환경에서 DMSF Plugin을 설치하는 전체 절차를 상세하게 정리한다.
단계별 권한 설정, UID/GID 확인, NAS 폴더 권한 부여, 플러그인 설치, 빌드 도구 설정, bundle install 및 rake 마이그레이션 절차까지 모두 실사용 환경 기준으로 작성하였다.
0. 설치 환경 정보
Environment:
Redmine version 6.1.0.stable
Ruby version 3.4.7-p58 (2025-10-08) [x86_64-linux]
Rails version 7.2.2.2
Environment production
Database adapter PostgreSQL
Mailer queue ActiveJob::QueueAdapters::AsyncAdapter
Mailer delivery smtp
Redmine settings:
Redmine theme Default
SCM:
Subversion 1.14.5
Mercurial 7.0.1
Bazaar 3.3.11
Git 2.47.3
Filesystem
Redmine plugins:
no plugin installed1. DMSF Plugins 사용자 UID/GID 확인
DMSF Plugin은 외부 폴더를 활용하는 경우가 많기 때문에 NAS 파일 시스템 권한과 Redmine 컨테이너 사용자 권한을 일치시키는 것이 가장 중요하다.
아래 명령을 통해 Redmine 컨테이너 내 redmine 사용자 UID/GID를 확인한다.
SSH 접속 프로그램이 없다면 MobaXterm Xserver 다운로드 (무설치 버전 있음)
root@Xpenology:~# docker exec -it redmine id redmine
uid=999(redmine) gid=999(redmine) groups=999(redmine)
## 예시 출력 : UID/GID는 NAS 폴더 chown 적용 시 필수 정보다.2. DMSF Plugins _ NAS 폴더 권한 설정
Synology NAS에 SSH 접속하여 root 권한을 획득한다.
Redmine의 plugins, files, themes, db 폴더는 컨테이너에서 redmine 사용자(예: UID 999)가 읽기/쓰기 가능해야 한다.
DMSF는 파일 저장, 버전 업로드, 폴더 생성, 심볼링 링크 처리 등을 수행하므로 퍼미션이 맞지 않으면 500 오류, 업로드 실패가 발생한다.
sudo -i
chown -R 999:999 /volume1/docker/redmine/db
chown -R 999:999 /volume1/docker/redmine/data
chown -R 999:999 /volume1/docker/redmine/pgadmin
chmod -R 755 /volume1/docker/redmine/data/plugins
chmod -R 755 /volume1/docker/redmine/data/themes
chmod -R 755 /volume1/docker/redmine/data/files3. 플러그인 다운로드 및 설치
레드마인 컨테이너 내부로 진입:
docker exec -u root -it redmine bash필수 패키지 설치 및 DMSF 플러그인 다운로드
docker exec -it redmine bash
cd /usr/src/redmine
apt-get update
apt-get upgrade
apt-get install zip
apt-get install vim
cd /usr/src/redmine/plugins
# DMSF 4.2.3
wget https://github.com/picman/redmine_dmsf/archive/refs/heads/master.zip
unzip master.zip
mv redmine_dmsf-master redmine_dmsf
rm -rf master.zip
exit참고: 다운로드 주소 확인 https://github.com/picman/redmine_dmsf.git
4. DMSF Plugins 폴더 권한 재 설정
plugins 디렉토리 안에 redmine_dmsf가 새로 생성되므로 다시 권한 적용:
chown -R 999:999 /volume1/docker/redmine/data/plugins/redmine_dmsf
chmod -R 755 /volume1/docker/redmine/data/plugins/redmine_dmsf5. 컨테이너 빌드 도구 설치
DMSF는 ox gem, xapian-ruby gem 등 컴파일이 필요한 의존성을 포함한다.
따라서 Redmine docker 내부에서 build-essential 및 zlib1g-dev 설치가 필수다.
docker exec -u root -it redmine bash
apt-get update
apt-get install -y build-essential zlib1g-dev ## ox / xapian-ruby 컴파일 필수 의존성
bundle install
## 설치 중 멈춘 것처럼 보일 수 있음 (xapian-ruby 컴파일로 10 ~ 20분 소요될 수 있음)
bundle exec rake redmine:plugins NAME=redmine_dmsf RAILS_ENV=production
exit
docker restart redmine6. 설치 정보 확인
Redmine 관리자 화면 → Administration → Plugins 로 이동하여
“DMSF” plugin이 정상적으로 표시되는지 확인한다.
추가 확인:
- DMSF 문서 메뉴가 프로젝트에 나타나는지
- 폴더 생성, 파일 업로드가 정상 동작하는지
- 업로드 후 파일 버전 생성 여부
- 권한/역할(Role) 설정에서 DMSF 항목 여러 개가 보이는지
7. 요약
핵심 요약
- Synology NAS + Docker 기반 Redmine 6.1.0에서 DMSF 플러그인을 설치하려면 **가장 중요한 단계는 권한 설정(UID/GID 일치)**이다.
- Redmine 컨테이너의 redmine 사용자 UID/GID를 확인하고 NAS 폴더에 동일하게 적용해야 한다.
- DMSF 플러그인은 기본 Redmine 문서 시스템을 대체하며, 문서 버전 관리, 워크플로우, 파일 잠금, 공유, 검색 기능 등을 향상시킨다.
- 설치 시
build-essential,zlib1g-dev등 의존성 설치가 필요하며, bundle install은 컴파일로 인해 최대 20분까지 소요될 수 있다. - 마이그레이션 후 Redmine 재시작을 수행하면 설치가 완료된다.
SEO 최적화 키워드 포함 요약
(검색 엔진 최적화를 위한 요약)
- Redmine 6.x DMSF Plugin 설치 방법
- Synology NAS Docker Redmine 플러그인 설치
- Redmine 문서 관리 플러그인 추천
- Redmine DMSF 설치 오류 해결
- xapian-ruby, ox gem 컴파일 이슈 해결
- Redmine plugins 디렉토리 권한 설정 방법
REV. 2025-11-26 : 기존 설치방법에서 폴더 권한 설정 및 필수 빌드 도구 설치 방법 추가
