Komga Docker 업데이트 방법: Docker Compose, 수동, 자동화 가이드
"아, 또 업데이트가 나왔네..." 혹시 콤가(Komga)를 도커 컨테이너로 사용하시는 분들 중에 이런 고민을 해보신 적 있나요? 만화나 만화책 서버로 정말 유용하게 쓰고 있는데, 최신 버전의 새로운 기능이나 버그 수정이 나올 때마다 어떻게 업데이트해야 할지 막막할 때가 있죠. 특히 도커에 익숙하지 않은 분들에겐 더더욱이요!
걱정 마세요! 오늘은 Komga 도커 컨테이너를 가장 확실하고 안전하게 업데이트하는 방법들을 아주 쉽고 친절하게 알려드릴게요. 수동으로 하나씩 해보는 방법부터, Docker Compose를 이용해 좀 더 편리하게, 그리고 Watchtower 같은 도구를 사용해서 완전히 자동화하는 방법까지 모두 다룰 거랍니다. 우리 모두 함께 최신 Komga를 즐겨봐요! 😊
가장 기본적이고 확실한 방법: 수동 업데이트 ✍️
먼저, 가장 전통적이고 확실한 방법인 수동 업데이트 절차를 알아볼게요. 이 방법은 도커에 익숙하지 않더라도 명령어 몇 가지만 알면 충분히 따라 할 수 있습니다. Komga 공식 문서에도 소개되어 있는 방법이니 신뢰하고 따라오셔도 좋아요!
이 방법은 컨테이너를 삭제하고 다시 생성하는 과정이 포함되지만, 걱정 마세요. 설정 파일이 호스트 폴더에 잘 매핑되어 있다면 기존 설정과 데이터는 그대로 유지됩니다.
아래는 단계별로 따라 하기 쉽게 정리한 명령어입니다.
-
1단계: 최신 Komga 이미지 다운로드
터미널에서 아래 명령어를 입력해 Docker Hub에 있는 최신 Komga 이미지를 가져옵니다.docker pull gotson/komga -
2단계: 기존 Komga 컨테이너 중지 및 삭제
현재 실행 중인 Komga 컨테이너를 멈추고 삭제합니다. 이 과정이 꼭 필요해요.docker stop komga && docker rm komga -
3단계: 새 컨테이너 생성 및 실행
다운로드한 최신 이미지를 사용하여 새 Komga 컨테이너를 생성하고 실행합니다. 이때 기존에 사용하던 모든 매개변수(볼륨, 포트, 환경변수 등)를 그대로 적용해야 데이터가 유지돼요.docker run -d --name komga -p 25600:25600 -v /path/to/config:/config -v /path/to/data:/data --restart unless-stopped gotson/komga -
4단계: 사용하지 않는 이미지 정리
업데이트 후에는 이전 버전의 이미지가 남아있을 수 있어요. 아래 명령어로 불필요한 이미지들을 깔끔하게 정리할 수 있습니다.docker image prune
더 간편하게: Docker Compose를 이용한 업데이트 🐳
만약 Komga를 Docker Compose로 관리하고 있다면, 업데이트 과정은 훨씬 더 간단해집니다. 별도의 삭제나 재실행 명령 없이 단 두 줄의 명령어로 끝낼 수 있거든요.
Docker Compose 파일을 사용하면 여러 컨테이너의 설정 정보를 한 번에 관리할 수 있어 편리해요. Komga 업데이트도 이 파일 하나로 해결할 수 있죠!
간단한 업데이트 명령어
1단계: 이미지 업데이트
docker compose pull komga
2단계: 컨테이너 재시작
docker compose up -d komga
Docker Compose를 사용하지 않고 개별 컨테이너를 관리한다면 `docker compose` 명령어가 아닌 `docker-compose` 명령어를 사용해야 할 수 있어요. 환경에 따라 다르니 확인하고 사용하세요!
더욱 스마트하게: 자동 업데이트 설정 🤖
매번 수동으로 업데이트하는 것도 번거롭다면, 자동 업데이트를 설정하는 방법도 있습니다. Watchtower와 같은 도구를 사용하면 도커 허브에 새로운 이미지가 올라왔을 때 자동으로 감지하여 컨테이너를 업데이트해 줍니다.
Watchtower를 이용한 자동 업데이트
Watchtower는 실행 중인 컨테이너 이미지를 주기적으로 확인하고, 새 이미지가 발견되면 기존 컨테이너를 안전하게 중지시킨 뒤 새 이미지로 컨테이너를 다시 시작해 줍니다.
| 구분 | 설명 | 장점 | 단점 |
|---|---|---|---|
| 수동 업데이트 | 직접 명령어를 입력해 업데이트하는 방법. | 가장 확실하고, 원하는 시점에만 업데이트 가능. | 매번 수동으로 명령어를 입력해야 함. |
| Docker Compose | Compose 파일을 이용해 한 번에 업데이트. | 간편하고 빠르며, 설정 정보를 일관되게 관리. | 그래도 명령어를 실행해야 함. |
| Watchtower | 컨테이너 이미지 자동 업데이트 도구. | 설치 후 자동으로 최신 버전을 유지. | 초기 설정이 필요하고, 예상치 못한 업데이트 발생 가능. |
Watchtower를 설치하려면 아래 명령어를 사용해 Watchtower 컨테이너를 실행하기만 하면 돼요.
docker run -d --name watchtower -v /var/run/docker.sock:/var/run/docker.sock containrrr/watchtower --cleanup --interval 120
`--cleanup` 옵션은 업데이트 후 이전 이미지를 자동으로 삭제해 주고, `--interval` 옵션은 업데이트 확인 주기를 설정해요 (위 예시는 120초).
실전 예시: 시놀로지(Synology) NAS에서의 업데이트 🖥️
시놀로지 NAS의 "Container Manager" (구 Docker)를 사용하시는 분들을 위한 팁이에요. NAS 환경에서는 GUI를 통해 좀 더 편리하게 업데이트할 수 있죠.
시놀로지 GUI를 이용한 업데이트 과정
- 1단계: 컨테이너 중지: Container Manager에서 Komga 컨테이너를 선택하고 '작업' > '중지'를 클릭합니다.
- 2단계: 최신 이미지 다운로드: '레지스트리' 메뉴로 이동해 `gotson/komga`를 검색하고 다운로드합니다. (기존 이미지를 삭제하지 않아도 괜찮아요!)
- 3단계: 기존 컨테이너 '지우기': 중지한 컨테이너를 다시 선택하고 '작업' > '지우기'를 선택합니다. 이 작업은 컨테이너 설정은 유지하고 컨테이너만 제거하는 기능이에요.
- 4단계: 컨테이너 시작점 '시작': 마지막으로 '작업' > '시작점'을 클릭하여 새 컨테이너를 기존 설정으로 다시 시작합니다.
최종 결과
- Komga가 최신 버전으로 업데이트되었습니다.
- 기존에 설정했던 라이브러리 경로, 사용자 계정 정보 등 모든 데이터가 그대로 유지됩니다.
시놀로지 NAS를 사용하시는 분들에게는 이 방법이 터미널 명령어를 쓰는 것보다 훨씬 직관적이고 편리할 거예요. 포테이너(Portainer)를 사용해서 관리하는 방법도 좋은 대안이 될 수 있으니 참고하세요.
마무리: 핵심 내용 요약 📝
오늘은 Komga 도커 컨테이너를 업데이트하는 세 가지 주요 방법을 알아보았어요. 여러분의 환경과 필요에 따라 가장 적합한 방법을 선택해서 사용하면 되겠죠?
- 수동 업데이트: `docker pull`, `docker stop`, `docker rm`, `docker run` 명령어를 순서대로 사용하는 가장 기본적인 방법이에요. 데이터 볼륨 매핑만 잘 되어있다면 안전하죠.
- Docker Compose: Compose 파일을 사용한다면 `docker compose pull`과 `docker compose up -d` 두 명령어로 간편하게 해결할 수 있어요.
- 자동 업데이트 (Watchtower): 한 번 설정해두면 신경 쓸 필요 없이 자동으로 최신 버전을 유지해주는 가장 편리한 방법이에요. 초기 설정이 조금 필요하지만, 그만큼 편리함을 제공하죠.
이 가이드가 여러분의 Komga 라이브러리 관리에 도움이 되었으면 좋겠네요. 혹시 궁금한 점이 있다면 언제든지 댓글로 남겨주세요! 😊
Komga Docker 업데이트 핵심 정리
