Debian, Ubuntu 또는 Linux Mint처럼 우분투 기반 배포판을 사용하다 보면 PPA(개인 패키지 아카이브)나 다른 저장소를 apt 소스에 추가하려는 순간 'add-apt-repository: command not found' 오류를 마주하게 됩니다. 이 오류는 대부분 해당 명령어를 제공하는 패키지가 시스템에 설치되어 있지 않기 때문에 발생합니다.
APT와 add-apt-repository란 무엇인가?
APT(Advanced Package Tool)는 Debian을 위해 개발된 패키지 관리자로, Ubuntu를 비롯한 데비안 계열 배포판에서 표준으로 사용됩니다. Ubuntu를 기반으로 하는 Linux Mint 역시 같은 패키지 관리자를 사용합니다. 리눅스 배포판에서 패키지 관리자는 시스템에 설치되는 모든 소프트웨어 패키지를 일관되게 관리해 주는 핵심 도구로, 프로그램의 설치·업데이트·삭제를 체계적으로 처리할 수 있게 해줍니다.
Ubuntu에는 저장소나 PPA를 터미널에서 손쉽게 등록할 수 있도록 도와주는 software-properties-common 패키지가 포함되어 있습니다. 이 패키지가 제공하는 add-apt-repository 명령어를 사용하면 apt 소스 파일(sources.list)을 직접 수정하지 않고도 한 줄의 명령으로 PPA를 추가할 수 있습니다.
'add-apt-repository: command not found' 오류의 원인
이 오류는 이름 그대로, add-apt-repository 명령어를 제공하는 패키지가 시스템에 없기 때문에 발생합니다. 좀 더 자세히 살펴보면 다음과 같습니다.
- 필수 패키지 누락: add-apt-repository 명령은 데비안 계열 운영체제에서 sources.list에 저장소를 자동으로 추가해 주는 전용 도구입니다. 이 명령어가 없다면 터미널에서 apt 소스 파일을 직접 편집하고 저장소를 수동으로 등록하는 번거로운 과정을 거쳐야 합니다. 즉, 저장소 추가 작업을 간편하게 만들어 주는 실용적인 도구인 셈입니다.
예를 들어 Ubuntu에 PPA를 추가할 때는 보통 다음과 같은 명령어를 사용합니다.
sudo add-apt-repository ppa:nameofppa
하지만 필요한 패키지가 설치되어 있지 않으면 아래와 같은 메시지가 출력되며 명령이 실행되지 않습니다.
add-apt-repository: command not found
add-apt-repository 설치하기
해결 방법은 매우 간단합니다. 명령어를 제공하는 패키지를 설치하기만 하면 됩니다. 다음 순서대로 진행해 보세요.
- 터미널을 엽니다. (단축키: Ctrl + Alt + T)
- 패키지 목록을 최신 상태로 갱신한 뒤, 아래 명령어로 필수 패키지를 설치합니다.
sudo apt update && sudo apt upgrade sudo apt install software-properties-common
- 설치가 완료되면 add-apt-repository 명령어를 정상적으로 사용할 수 있습니다.
- 만약 '패키지를 찾을 수 없다(E: Unable to locate package)'는 오류가 나타난다면, 시스템에 등록된 미러 서버가 오래되었거나 저장소 설정에 문제가 있을 가능성이 높습니다. 먼저 이를 해결해야 합니다.
- Ubuntu 12.04 이상 버전에서는 터미널에서 다음 명령어를 실행하여 소프트웨어 설정 창을 열 수 있습니다.
sudo software-properties-gtk
- 소프트웨어 설정 창이 열리면 첫 번째 탭(Ubuntu 소프트웨어)에서 다운로드 서버 위치를 확인하고, 가장 적합한 서버로 변경합니다.
- 다운로드 위치 드롭다운 메뉴를 클릭한 후 '기타(Other)'를 선택합니다.
- 이어서 '최적의 서버 선택(Select Best Server)' 버튼을 클릭합니다. Ubuntu가 잠시 동안 연결 상태를 점검한 뒤 가장 빠르고 최신 상태의 미러 서버를 자동으로 찾아줍니다. 완료되면 설정 창을 닫으면 됩니다.
- 여기까지 진행하면 미러 서버 문제는 해결된 상태입니다.
- 마지막으로 앞서 안내한 설치 명령어를 다시 실행합니다. 이제 software-properties-common 패키지가 정상적으로 설치될 것입니다.
- 설치가 끝나면 더 이상 'command not found' 오류 없이 터미널에서 PPA와 저장소를 자유롭게 추가할 수 있습니다.