Raspberry Pi Imager는 microSD 등에 Raspberry Pi 운영체제를 기록하고, 첫 부팅에 사용할 계정·Wi-Fi·SSH를 미리 설정하는 도구입니다. Raspberry Pi 4·5·Zero 계열 등 지원되는 컴퓨터를 준비할 때 사용합니다.
첨부한 RaspberryPiImager-2.0.11.1-Windows-setup.zip에는 공식 Windows 설치 실행 파일과 원본 라이선스가 들어 있습니다. 설치 프로그램을 ZIP으로 묶은 파일이며 포터블 프로그램이나 OS 이미지가 아닙니다. 한국어 사용법과 첫 부팅 확인표는 RaspberryPiImager-guide-ko.zip으로 따로 제공합니다.
1. 설치와 준비물
- 설치 ZIP을 풀고
imager-v2.0.11.1.exe를 실행해 설치합니다. 실행 파일은 공식 GitHub 릴리스의 SHA-256과 대조한 원본입니다. - 사용할 Raspberry Pi, 호환되는 전원 공급기, 용량이 충분한 microSD와 카드 리더를 준비합니다.
- OS 이미지를 받을 인터넷 연결을 준비합니다. macOS·Linux용 프로그램은 공식 소프트웨어 페이지에서 받습니다.
- SD 카드에 필요한 파일이 있으면 다른 저장장치에 백업합니다.
이 절차는 Raspberry Pi 컴퓨터의 OS 설치용입니다. RP2040·RP2350 기반 Pico의 UF2 펌웨어 설치와는 별도입니다.
2. 기기·OS·저장장치 선택
- Imager를 열고 Device 단계에서 실제 Raspberry Pi 모델을 선택합니다.
- OS에서 해당 모델에 맞는 운영체제를 선택합니다. 화면이 필요한 경우 데스크톱 포함판, SSH로 사용할 경우 Lite판 등을 목적에 맞게 고릅니다.
- Storage에서 기록할 microSD를 선택합니다. 용량과 장치 이름을 확인해 다른 USB 저장장치와 구분합니다.
- 이어지는 사용자 설정 단계로 진행합니다. 화면 명칭과 제공 설정은 Imager·OS 버전에 따라 다를 수 있습니다.
기록을 시작하면 선택한 저장장치의 기존 데이터가 삭제됩니다. 쓰기 직전에 대상 이름·용량을 다시 확인하세요. 아래 예시는 Raspberry Pi OS를 기준으로 하며 다른 OS는 사용자 설정을 일부 지원하지 않을 수 있습니다.
3. Wi-Fi·사용자·SSH 미리 설정
| 항목 | 설정 방법 |
|---|---|
| Hostname | 예: iot-pi. 같은 네트워크의 다른 장치와 겹치지 않게 지정 |
| 사용자 계정 | 직접 사용할 이름과 암호 설정. 접속할 때 이 이름 사용 |
| Wi-Fi | 실제 SSID·암호 입력. 기기가 지원하는 주파수 대역 확인 |
| 지역 설정 | 사용 지역의 시간대·키보드·무선 국가 설정. 한국 사용 시 해당 항목에 KR 선택 |
| SSH | 원격 접속을 사용하면 활성화하고 암호 또는 공개 키 인증 설정 |
예제에는 실제 암호나 개인 키가 없습니다. 공개 키 인증을 선택했다면 접속할 PC의 공개 키를 등록하고 개인 키는 해당 PC에서 보관합니다. 예전 안내의 기본 사용자 pi를 그대로 가정하지 말고 이번에 만든 계정을 사용하세요.
4. 쓰기·검증·첫 부팅
- 최종 확인 화면에서 모델·OS·대상 저장장치와 사용자 설정을 확인합니다.
- 쓰기 확인 후 다운로드·기록·검증이 끝날 때까지 카드를 분리하지 않습니다.
- 완료 안내에 따라 카드를 안전하게 분리합니다.
- Raspberry Pi의 전원이 꺼진 상태에서 카드를 넣고 필요한 네트워크 케이블을 연결합니다.
- 해당 모델에 맞는 전원을 연결하고 첫 부팅·초기 설정이 끝날 때까지 기다립니다.
기록 후 Windows가 다른 파티션을 포맷하라고 표시하더라도 새 OS 파티션을 포맷하지 않습니다. Linux용 파티션을 Windows가 읽지 못해서 나타나는 안내일 수 있습니다.
5. SSH 접속과 문제 해결
PC와 Raspberry Pi가 같은 네트워크에 있다면 터미널에서 아래처럼 접속합니다. your-user는 Imager에서 만든 사용자 이름으로 바꾸고, 호스트 이름도 실제 설정값으로 바꿉니다.
ssh your-user@iot-pi.local처음 접속할 때 표시되는 호스트 키 지문은 장치 콘솔 등 신뢰할 수 있는 경로의 값과 확인합니다. 접속 후 아래 명령으로 장치 이름·사용자·시스템 정보를 읽을 수 있습니다.
hostname
whoami
uname -a- .local 이름을 찾지 못함: 공유기 접속 목록에서 IP를 확인해 호스트 이름 대신 입력합니다.
- Wi-Fi 연결 안 됨: SSID·암호, 국가·지원 대역, 전원과 공유기 상태를 확인합니다.
- SSH 연결 거절: SSH 활성화 여부와 부팅 완료 상태를 확인합니다.
- 인증 실패: 사용자 이름과 선택한 암호·공개 키 인증 방식이 맞는지 확인합니다.
- 쓰기·검증 실패: 카드 리더·SD 상태와 USB 연결을 확인하고 다시 시도할 때도 대상 저장장치를 재확인합니다.
6. 첨부 자료와 공식 문서
사용법 ZIP에는 오프라인 설명서, firstboot-checklist.txt, connection-example.txt가 있습니다. 설치 ZIP은 Windows용 Imager만 포함하므로 OS 이미지는 프로그램에서 별도로 받습니다.
자료 확인일: 2026년 9월 12일. 공식 설치 실행 파일은 변경하지 않았으며 배포 프로젝트와 포함 구성요소의 원본 라이선스를 함께 제공합니다.