Docker, Docker-compose 설치(최신)

apt-key is deprecated, apt-key: command not found 해결법
Warning, Error 발생 이유
Docker 설치 과정에서 apt-key 방식으로 GPG key를 등록하려 하면 아래같은 Warning이 뜹니다.
Warning: apt-key is deprecated. Manage keyring files in trusted.gpg.d instead (see apt-key(8)).
apt-key 방식은 여러 보안 문제로 권장 되지 않는 방식입니다.
Ubuntu 25.04같은 최근 버전에서는 apt-key
가 아예 설치가 안 되어있기도 합니다.
apt-key: command not found
Docker 설치
- 패키지 업데이트, 의존성 패키지 설치
sudo apt-get update
sudo apt-get install ca-certificates curl
- Docker 공식 GPG key 등록
sudo install -m 0755 -d /etc/apt/keyrings
sudo curl -fsSL https://download.docker.com/linux/ubuntu/gpg -o /etc/apt/keyrings/docker.asc
sudo chmod a+r /etc/apt/keyrings/docker.asc
- Docker 공식 레포지토리 등록
echo \
"deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.asc] https://download.docker.com/linux/ubuntu \
$(. /etc/os-release && echo "${UBUNTU_CODENAME:-$VERSION_CODENAME}") stable" | \
sudo tee /etc/apt/sources.list.d/docker.list > /dev/null
- 패키지 업데이트
sudo apt-get update
- Docker 설치
sudo apt-get install docker-ce
- Docker 설치 확인
sudo systemctl status docker
아래와 같이 출력되면 성공!

Docker-compose 설치
- Docker-compose 설치
sudo curl -L "https://github.com/docker/compose/releases/latest/download/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
- Docker-compose 권한 부여
sudo chmod +x /usr/local/bin/docker-compose
- 심볼릭 링크 설정
sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
- 설치 확인
sudo docker-compose -v
아래처럼 버전이 나오면 성공!
Docker Compose version v2.35.1
Reference:
Docker 공식 홈페이지
sudo 없이 사용하기
docker, docker-compose 사용 시 매번 sudo로 실행해야 됩니다.
보안을 위해서지만 매번 sudo를 사용하는 것을 귀찮습니다.
docker
그룹에 사용자 추가:
sudo usermod -aG docker $USER
셸에 재 접속하여 다음 명령어로 확인합니다.
docker ps
docker-compose -v