Portainer에서 이미 받은 Docker 이미지로 컨테이너를 띄우려면, Portainer UI에서 Containers → Add container 메뉴를 사용해 이미지 이름을 지정하고 배포하면 된다.
기본 실행 절차
-
브라우저에서 Portainer 접속
-
예:
http://<호스트-IP>:9000또는 설정한 포트로 접속.
-
-
좌측 메뉴에서 Containers 클릭.
-
우측 상단 Add container 버튼 클릭.
컨테이너 설정
-
Name
-
실행할 컨테이너 이름을 입력 (예:
my-app).
-
-
Image
-
nginx:latest처럼 실행할 이미지 이름과 태그를 입력. -
로컬에 이미 있는 이미지면 바로 사용되고, 없으면 Docker Hub 등 레지스트리에서 받아온다.
-
-
(선택) Registry / Always pull the image
-
프라이빗 레지스트리 사용 시 Registry 선택.
-
이미지를 매번 새로 받고 싶으면 Always pull the image 토글 on.
-
포트, 볼륨 등 추가 설정
필요에 따라 아래를 설정한다.
-
Publish a new network port
-
예: 컨테이너 80포트를 호스트 8080으로 노출
-
host: 8080,container: 80입력 후 추가.
-
-
Volumes
-
호스트 디렉터리나 Docker volume을 컨테이너에 마운트해서 데이터 영속성 확보.
-
-
Env vars / Restart policy
-
환경변수, 재시작 정책 등을 필요에 맞게 지정.
-
컨테이너 배포 및 실행 확인

-
화면 맨 아래 Deploy the container 버튼 클릭.
-
Containers 목록에서 방금 만든 컨테이너가
running상태인지 확인. -
포트 매핑을 했다면
http://<호스트-IP>:<호스트포트>로 접속하여 서비스 확인.