Komga Docker, 최신 버전으로 안전하고 빠르게 업데이트하는 완벽 가이드!
개인 디지털 만화 라이브러리를 구축하고 계신가요? 📚 그렇다면 아마도 **Komga(콤가)**를 Docker 컨테이너로 설치해서 사용하고 계실 거예요. 맞죠? Komga는 정말 훌륭한 만화 서버지만, 새로운 기능이 추가되거나 버그가 수정될 때마다 **업데이트**를 해줘야 하는데요, 이게 또 Docker 환경에서는 조금 헷갈릴 수 있거든요.
이 글에서는 **Komga Docker 컨테이너를 가장 안전하고 빠르게 최신 버전으로 업데이트하는 완벽한 방법**을 단계별로 자세히 알려드릴게요. 이 글을 끝까지 읽으시면 데이터 손실 걱정 없이 업데이트를 성공적으로 마무리할 수 있을 거예요! 😊
첫 번째 주요 섹션 제목: ⚠️ 업데이트 전, 이것부터 확인하세요! 🤔
Komga를 업데이트하기 전에 가장 먼저 확인해야 할 것은 바로 **데이터 백업**과 **설정 파일** 위치입니다. 데이터 손실을 막는 가장 기본적인 단계거든요.
Komga는 보통 Docker 컨테이너 외부의 볼륨에 설정 파일과 데이터베이스 파일(SQLite 등)을 저장하도록 구성되어 있어요. 이 파일을 안전하게 백업해두는 것이 가장 중요합니다. 혹시 모를 상황에 대비하는 거죠.
Komga의 설정 및 데이터베이스 파일은 보통 Docker 실행 시 지정한 `/config` 볼륨에 저장됩니다. (예: `/volume1/docker/komga/config/`와 같은 경로) 이 폴더 전체를 압축하거나 복사하여 별도의 안전한 위치에 백업해두는 것이 좋습니다.
두 번째 주요 섹션 제목: 💻 Docker Compose 기반 업데이트 프로세스 📊
대부분의 사용자분들이 **Docker Compose** 파일을 이용해서 Komga를 설치하셨을 거예요. 이 방식이 가장 간편하고 표준적인 업데이트 방법입니다. 이 섹션에서는 이 방법을 기준으로 설명해 드릴게요.
특별히 강조하고 싶은 내용이라면, **Docker Compose 파일(`docker-compose.yml`)은 절대 수정하지 마세요!** Komga 이미지 이름만 확인하면 됩니다. 보통 `image: gotson/komga:latest`로 설정되어 있을 거예요.
**Komga Docker 업데이트 4단계 요약**
| 구분 | 명령어 | 설명 | 비고 |
|---|---|---|---|
| 1단계 | `docker-compose pull` | 최신 이미지 다운로드 | 업데이트 파일 준비 |
| 2단계 | `docker-compose down` | 현재 컨테이너 중지 및 제거 | 데이터는 유지됨 |
| 3단계 | `docker-compose up -d` | 최신 이미지로 컨테이너 재생성 | 가장 중요한 단계 |
| 4단계 | Komga 접속 확인 | 웹 UI에서 버전 확인 | 업데이트 성공 확인 |
`docker-compose down` 명령어는 컨테이너를 제거하지만, 볼륨으로 지정된 설정 파일과 만화 파일은 그대로 보존됩니다. 하지만 백업은 언제나 최선이므로, 1단계에서 언급한 백업을 꼭 완료한 후에 진행해 주세요!
세 번째 주요 섹션 제목: 📝 터미널 명령어를 이용한 실제 업데이트 과정 🧮
자, 이제 실제로 SSH나 터미널을 이용해 업데이트를 진행해볼게요. Komga의 `docker-compose.yml` 파일이 있는 경로로 이동하는 것이 가장 먼저 할 일입니다.
**1단계: 최신 이미지 다운로드**
터미널에서 아래 명령어를 실행하여 최신 이미지를 받아옵니다.
`**docker-compose pull komga**` (서비스 이름이 'komga'인 경우)
이미지가 성공적으로 다운로드되었다는 메시지를 확인했다면 다음 단계로 넘어갑니다:
**2단계 및 3단계: 기존 컨테이너 중지 및 새 컨테이너 실행**
이 두 단계를 하나의 명령어로 실행하는 것이 가장 효율적입니다.
`**docker-compose up -d**`
이 명령어는 기존 컨테이너를 종료하고, 1단계에서 다운로드한 최신 이미지를 사용하여 **새로운 Komga 컨테이너**를 생성하고 백그라운드(`-d`)로 실행시킵니다. 기존 컨테이너와 연결했던 볼륨 정보(설정, 라이브러리)는 그대로 유지되니 걱정 마세요.
**🔢 업데이트 상태 확인 유용한 명령어**
`docker ps | grep komga`
`docker logs komga`
네 번째 주요 섹션 제목: 👩💼👨💻 Docker 단독 실행 환경에서의 업데이트 (Run 명령어)
Docker Compose 대신 **`docker run` 명령어** 하나로 Komga를 설치해서 사용하시는 분들도 계실 거예요. 이 경우에도 업데이트 과정은 크게 다르지 않습니다. 기존 컨테이너를 제거하고 최신 이미지로 다시 생성하는 방식이거든요.
1. **기존 컨테이너 중지:** `docker stop [komga 컨테이너 이름]`
2. **기존 컨테이너 제거:** `docker rm [komga 컨테이너 이름]`
3. **최신 이미지 다운로드:** `docker pull gotson/komga:latest`
4. **새 컨테이너 실행:** 처음 Komga를 설치할 때 사용했던 `docker run ...` 명령어를 그대로 다시 실행합니다. 이때 볼륨 설정( `-v /your/path/to/config:/config` 등)이 올바른지 반드시 확인해야 기존 설정과 데이터를 유지할 수 있습니다.
실전 예시: 40대 직장인 박모모씨의 업데이트 사례 📚
실제 사례를 통해 업데이트 과정을 더 확실히 이해해볼게요. 40대 직장인 박모모씨는 Synology NAS에 Docker Compose로 Komga를 설치해두고 사용 중이셨어요.
**사례 주인공의 상황**
- 정보 1: Komga 컨테이너 이름은 `komga`로 설정되어 있었음
- 정보 2: `docker-compose.yml` 파일은 `/volume1/docker/komga` 경로에 위치
- 정보 3: 업데이트 전, `/volume1/docker/komga/config` 폴더 전체를 백업 완료
**실제 업데이트 과정**
1) 첫 번째 단계: SSH 접속 후 `/volume1/docker/komga` 경로로 이동
2) 두 번째 단계: `docker-compose pull` 명령어로 최신 이미지 다운로드
3) 세 번째 단계: `docker-compose up -d` 명령어로 기존 컨테이너 교체 및 실행
**최종 결과**
- 결과 항목 1: Komga 웹페이지 접속 성공, 기존 라이브러리와 설정 유지 확인
- 결과 항목 2: 웹 UI 하단에서 **최신 버전 번호** 확인, 업데이트 성공!
박모모씨의 사례처럼 Docker Compose를 사용하면 단 두 줄의 명령어로 업데이트를 마칠 수 있어요. 백업만 잘 되어 있다면 정말 간단하죠!
마무리: 핵심 내용 요약 📝
Komga Docker 업데이트, 생각보다 어렵지 않으셨죠? 핵심은 **백업**과 **`docker-compose up -d`** 명령어입니다. 다시 한번 핵심 내용을 정리해볼게요.
- 첫 번째 핵심 포인트. **설정 폴더를 반드시 백업**하여 만일의 사태에 대비합니다.
- 두 번째 핵심 포인트. 업데이트는 기존 컨테이너를 지우고 **새 컨테이너를 생성하는 방식**으로 진행됩니다.
- 세 번째 핵심 포인트. Docker Compose 사용자는 `**docker-compose pull`** 후 `**docker-compose up -d**` 두 명령어로 끝!
- 네 번째 핵심 포인트. Docker Run 사용자는 `stop`, `rm`, `pull` 후 **기존 run 명령어**를 다시 사용합니다.
- 다섯 번째 핵심 포인트. 업데이트 후 웹 UI에서 **최신 버전이 맞는지** 꼭 확인하세요.
이제 최신 기능이 적용된 Komga에서 즐겁게 만화를 즐기시면 됩니다! 업데이트가 잘 안되거나 궁금한 점이 있다면 언제든지 댓글로 물어봐주세요~ 😊
Komga Docker 업데이트 핵심 요약
