본문으로 바로가기

Anaconda 환경과 JupyterLab을 처음부터 설치하는 순서

결론부터 말하면, Anaconda 설치는 설치 프로그램이 끝났다는 화면보다 conda, Python, JupyterLab 버전을 차례로 확인하고 새 노트북에서 계산 하나를 실행해야 완료로 판단할 수 있다.

2026-08-22 UTC에 Anaconda 공식 Docker Hub 배포 이미지의 고정 태그 continuumio/anaconda3:2024.10-1을 임시 컨테이너에서 실행했다. conda 24.9.2, Python 3.12.7, JupyterLab 4.2.5를 확인했고 NumPy 배열 합계가 6으로 계산됐다.

이 글은 처음 설치할 때 확인할 순서를 설명한다. 검증은 Linux 컨테이너에서 했으므로 Windows와 macOS의 설치 화면, 메뉴 이름과 PATH 동작은 운영체제에 따라 다를 수 있다.

이 글로 해결할 수 있는 것

  • 공식 설치 파일과 임의 재배포 파일을 구분한다.
  • 설치 완료와 Jupyter 커널 실행 가능 상태를 따로 확인한다.
  • 브라우저가 자동으로 열리지 않을 때 터미널 URL과 포트를 점검한다.

1. 공식 배포 경로와 운영체제를 확인한다

Anaconda 공식 다운로드 페이지에서 자신의 운영체제와 CPU에 맞는 배포판을 선택한다. 회사나 학교 장비라면 설치 권한과 Anaconda 이용 조건도 먼저 확인한다. 검색 광고나 제3자 파일 공유 사이트에서 설치 파일을 받지 않는다.

2. 설치 위치를 기록하고 기본 환경부터 확인한다

설치 후 Anaconda Prompt 또는 터미널을 새로 열고 아래 명령을 실행한다. 셸이 이전 PATH를 기억할 수 있어 설치 전에 열어 둔 터미널보다 새 터미널이 안전하다.

conda --version
python --version
jupyter lab --version

세 명령 중 하나가 없다고 나오면 재설치부터 하지 말고 현재 터미널이 Anaconda 환경을 가리키는지, 설치 위치가 PATH에 반영됐는지 먼저 확인한다.

3. 프로젝트마다 별도 환경을 만든다

모든 패키지를 base에 섞기보다 프로젝트 환경을 분리하면 버전 충돌을 줄이고 나중에 재현하기 쉽다.

conda create -n ai-practice python=3.12
conda activate ai-practice
conda install jupyterlab numpy pandas
jupyter lab

패키지 버전은 실행 시점의 채널과 운영체제에 따라 달라질 수 있다. 설치가 끝나면 conda list 또는 환경 파일로 실제 버전을 남긴다.

4. 브라우저와 커널을 각각 확인한다

jupyter lab 실행 뒤 브라우저가 자동으로 열리지 않아도 서버가 실패한 것은 아니다. 터미널에 표시된 http://localhost:포트/lab?token=... 주소를 같은 컴퓨터의 브라우저에서 연다. 토큰이 포함된 전체 주소는 캡처나 공개 글에 노출하지 않는다.

새 Python 노트북을 만들고 다음 셀을 실행한다.

import sys
import numpy as np

print(sys.executable)
print(np.array([1, 2, 3]).sum())

합계 6과 현재 환경의 Python 경로가 나오면 브라우저 화면뿐 아니라 커널 실행까지 확인한 것이다. 다른 Python 경로가 나오면 Jupyter가 다른 환경의 커널을 선택했는지 확인한다.

직접 실행한 결과

항목확인값
배포 이미지continuumio/anaconda3:2024.10-1
이미지 digestsha256:b2c5350c…02cf8c3a
conda24.9.2
Python3.12.7
JupyterLab4.2.5
NumPy / Pandas1.26.4 / 2.2.2
커널 계산[1, 2, 3] 합계 6

브라우저가 열리지 않을 때 확인 순서

  1. 터미널에서 Jupyter 프로세스가 계속 실행 중인지 본다.
  2. 출력된 주소와 포트가 브라우저 주소와 같은지 본다.
  3. 원격 서버라면 localhost가 어느 컴퓨터를 뜻하는지 확인한다.
  4. 방화벽과 컨테이너 포트 공개 여부를 확인한다.
  5. 서버 로그의 첫 오류를 확인한 뒤 환경과 패키지를 바꾼다.

결과와 한계

이번 검증은 고정된 Linux 컨테이너 이미지의 기존 패키지를 실행한 결과다. 데스크톱 설치 프로그램 자체, Navigator GUI, GPU 패키지, Windows 오류와 macOS 보안 승인은 검증하지 않았다. 또한 2024.10-1은 최신판을 주장하기 위한 태그가 아니라 재현 가능한 실습 기준이다.

다음 단계

환경이 실행되면 패키지 설치 전후의 conda list를 저장하고, 다음 글의 선형회귀 예제를 새 노트북에서 실행해 코드와 커널이 같은 환경을 사용하는지 확인한다.

출처와 변경 이력