---
title: "Docker 컨테이너를 GUI로 쉽게 관리하는 Portainer 설치 가이드"
description: "Docker 컨테이너를 GUI로 관리할 수 있는 Portainer 설치 방법을 소개합니다. Portainer는 오픈소스 플랫폼으로, 컨테이너 생성, 이미지 관리, 볼륨 및 네트워크 설정을 쉽게 할 수 있습니다. 설치 전 Docker가 필요하며, 볼륨을 생성한 후 컨테이너를 실행하고 웹 브라우저를 통해 초기 설정을 진행합니다. GPU 지원 설정과 docker-compose를 이용한 설치 방법도 안내하며, 업데이트 절차도 설명합니다."
date: "2024-07-18"
last_modified: "2026-05-15T08:36:00.000Z"
type: "Post"
tags:
  - "docker"
  - "install"
  - "Open Source"
categories:
  - "📗 Docs"
canonical_url: "https://blog.pieroot.xyz/portainer-install"
markdown_url: "https://blog.pieroot.xyz/portainer-install.md"
---

# Docker 컨테이너를 GUI로 쉽게 관리하는 Portainer 설치 가이드

Docker 컨테이너를 GUI로 관리할 수 있는 Portainer 설치 방법을 소개합니다. Portainer는 오픈소스 플랫폼으로, 컨테이너 생성, 이미지 관리, 볼륨 및 네트워크 설정을 쉽게 할 수 있습니다. 설치 전 Docker가 필요하며, 볼륨을 생성한 후 컨테이너를 실행하고 웹 브라우저를 통해 초기 설정을 진행합니다. GPU 지원 설정과 docker-compose를 이용한 설치 방법도 안내하며, 업데이트 절차도 설명합니다.

## 들어가며

안녕하세요! 오늘은 Docker 컨테이너를 GUI로 편리하게 관리할 수 있는 **Portainer**를 설치하는 방법을 공유하려고 합니다.

Docker를 CLI로만 관리하다 보면 컨테이너 상태 확인, 로그 조회, 이미지 관리 등이 번거롭게 느껴질 때가 있죠. 특히 리눅스 서버에 원격 데스크톱으로 접속해서 작업하는 것은 자원 낭비가 심합니다. 이런 불편함을 해소해주는 것이 바로 **Portainer**입니다.

> **Portainer란?**
> 
> Portainer는 Docker, Swarm, Kubernetes 환경을 웹 브라우저에서 손쉽게 관리할 수 있는 **오픈소스 컨테이너 관리 플랫폼**입니다. 직관적인 UI를 통해 컨테이너 생성, 모니터링, 볼륨 관리, 네트워크 설정 등을 간편하게 수행할 수 있습니다.

![image](https://blog.pieroot.xyz/api/image-proxy?id=a00b2df0-6f88-432e-a480-7045049c998f&kind=s3&pageId=21e067c0-15d0-804b-beb0-ef917c1df1a7&source=block&blockId=2e4067c0-15d0-80c0-9b5d-d17a8e2b2405)

#### Portainer의 주요 기능

Portainer에는 **Community Edition(CE)**과 **Business Edition(BE)** 두 가지 버전이 있습니다. 이 글에서는 무료로 사용할 수 있는 CE 버전을 설치합니다.

[Install Portainer CE with Docker on Linux \| Portainer Documentation](https://docs.portainer.io/start/install-ce/server/docker/linux)

---

### 📋 사전 요구사항

Portainer를 설치하기 전에 다음 사항을 확인하세요.

> **필수 요구사항**
> 
> - Docker가 설치되어 있어야 합니다
> 
> - Docker 데몬이 실행 중이어야 합니다
> 
> - 포트 9000(HTTP) 또는 9443(HTTPS)이 사용 가능해야 합니다

Docker 설치 여부는 다음 명령어로 확인할 수 있습니다.

```bash
docker --version
docker ps
```

---

### 🚀 Portainer 설치

#### 1단계: 볼륨 생성

먼저 Portainer의 설정과 데이터를 영구적으로 저장할 Docker 볼륨을 생성합니다.

```bash
docker volume create portainer_data
```

> **볼륨이 필요한 이유**
> 
> 볼륨을 사용하면 컨테이너가 삭제되거나 업데이트되어도 설정 데이터가 유지됩니다. Ubuntu에서 볼륨은 `/var/lib/docker/volumes/` 경로에 저장됩니다.

#### 2단계: Portainer 컨테이너 실행

이제 Portainer 컨테이너를 실행합니다.

```bash
docker run -d \
  -p 8000:8000 \
  -p 9000:9000 \
  -p 9443:9443 \
  --name portainer \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest
```

#### 명령어 옵션 설명

> **포트 설정 안내**
> 
> 콜론(`:`) 앞쪽이 **호스트(서버) 포트**, 뒤쪽이 **컨테이너 내부 포트**입니다. 호스트 포트가 이미 사용 중이라면 `-p 19000:9000`처럼 다른 포트 번호로 변경할 수 있습니다.

---

### 🖥️ 초기 설정

컨테이너가 정상적으로 실행되면 웹 브라우저에서 Portainer에 접속할 수 있습니다.

- **HTTP 접속**: [`http://서버IP:9000`](http://xn--ip-v41jw5m:9000/)

- **HTTPS 접속**: [`https://서버IP:9443`](https://xn--ip-v41jw5m:9443/)

> **로컬 테스트 시**: [http://127.0.0.1:9000](http://127.0.0.1:9000/) 또는 [https://127.0.0.1:9443](https://127.0.0.1:9443/)
> 
> **외부 서버 접속 시**: 방화벽에서 해당 포트가 열려 있는지 확인하세요.

![image](https://blog.pieroot.xyz/api/image-proxy?id=1d4fc1ff-ae23-496e-961d-795696ecf799&kind=s3&pageId=21e067c0-15d0-804b-beb0-ef917c1df1a7&source=block&blockId=21e067c0-15d0-8080-9eca-cdb1c37e3d6b)

처음 접속하면 **관리자 계정 생성 화면**이 나타납니다. 사용할 사용자명과 비밀번호를 입력하여 계정을 생성하세요.

> **중요**: 이 계정 정보를 분실하면 Portainer 데이터를 모두 삭제하고 재설치해야 합니다. 반드시 안전한 곳에 기록해두세요!

관리자 계정을 생성한 후 "Get Started"를 클릭하면 로컬 Docker 환경이 자동으로 감지되어 관리할 수 있습니다.

---

### 🎮 GPU 지원 설정 (선택사항)

NVIDIA GPU가 장착된 서버에서 GPU 할당 정보를 Portainer에서 확인하려면 NVIDIA 런타임을 연결해야 합니다.

```bash
docker run -d \
  --runtime=nvidia \
  --gpus all \
  -p 9000:9000 \
  --name=portainer \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest
```

> **사전 요구사항**: NVIDIA Container Toolkit이 설치되어 있어야 합니다. 설치 방법은 [NVIDIA 공식 문서](https://docs.nvidia.com/datacenter/cloud-native/container-toolkit/install-guide.html)를 참고하세요.

---

### 🔄 Portainer 업데이트

Portainer를 최신 버전으로 업데이트하는 방법입니다. 볼륨에 데이터가 저장되어 있으므로 설정은 유지됩니다.

```bash
# 1. 기존 컨테이너 중지
docker stop portainer

# 2. 기존 컨테이너 제거
docker rm portainer

# 3. 최신 이미지 다운로드
docker pull portainer/portainer-ce:latest

# 4. 새 컨테이너 실행
docker run -d \
  -p 9000:9000 \
  --name=portainer \
  --restart=always \
  -v /var/run/docker.sock:/var/run/docker.sock \
  -v portainer_data:/data \
  portainer/portainer-ce:latest
```

> **팁**: `portainer_data` 볼륨을 삭제하지 않는 한 기존 설정, 사용자 계정, 환경 구성이 모두 유지됩니다.

---

### 🔧 docker-compose를 이용한 설치 (대안)

docker-compose를 선호한다면 아래 방법으로도 설치할 수 있습니다.

```yaml
version: '3.3'
services:
  portainer:
    image: portainer/portainer-ce:latest
    container_name: portainer
    restart: unless-stopped
    volumes:
      - /var/run/docker.sock:/var/run/docker.sock
      - portainer_data:/data
    ports:
      - 8000:8000
      - 9000:9000
      - 9443:9443

volumes:
  portainer_data:
```

위 내용을 `docker-compose.yml` 파일로 저장한 후 실행합니다.

```bash
docker-compose up -d
```

---

### 🎯 마무리

지금까지 Docker 컨테이너 관리 도구인 Portainer CE를 설치하는 방법을 알아보았습니다.

> **정리**
> 
> 1. `docker volume create`로 데이터 저장용 볼륨 생성
> 
> 1. `docker run`으로 Portainer 컨테이너 실행
> 
> 1. 웹 브라우저에서 초기 관리자 계정 생성
> 
> 1. 필요 시 GPU 지원 설정 또는 docker-compose 활용

Portainer를 사용하면 CLI에 익숙하지 않은 분들도 Docker를 쉽게 관리할 수 있고, 숙련된 사용자도 컨테이너 상태를 한눈에 파악할 수 있어 생산성이 크게 향상됩니다.

다음에는 Nginx 리버스 프록시를 설정하여 Portainer에 도메인을 연결하고 SSL 인증서를 적용하는 방법을 다뤄보겠습니다.

---

#### 📚 참고 자료

- [Portainer 공식 문서 - Install Portainer CE](https://docs.portainer.io/start/install-ce/server/docker/linux)

- [Docker Hub - portainer/portainer-ce](https://hub.docker.com/r/portainer/portainer-ce)

- [서버포럼 - Docker 관리를 위한 툴 Portainer 설치하기](https://svrforum.com/svr/867047)