Sourcetree(https://www.sourcetreeapp.com) 설치 후 계정 연결과 비밀번호 인증 오류
Sourcetree(https://www.sourcetreeapp.com) 설치 후 자세히 보기 >
Sourcetree는 아틀라시안이 만든 무료 Git 화면 프로그램입니다. 아래에서 Sourcetree 맥·윈도우 최신판과 받을 파일, 설치 순서, 원격 계정 연결, 비밀번호 인증이 안 될 때, 기업용 설치, 이전 판 받기와 지원 기능까지 공식 문서와 릴리스 노트 기준으로 정리했습니다.
체크 포인트
계정 비밀번호로는 인증 안 됨 — 앱 비밀번호나 API 토큰을 넣어야 합니다 · 맥판과 윈도우판 번호가 다름 — 맥 4.2.19(macOS 10.15 이상), 윈도우 3.4.32 · SSH 키 단계에서 막히면 HTTPS — 공식 설치 안내가 그렇게 넘어가라고 적고 있습니다
Sourcetree 맥·윈도우 최신판과 받을 파일
Sourcetree는 맥판과 윈도우판이 따로 개발됩니다. 그래서 판 번호가 서로 다릅니다.
| 구분 | 내용 |
|---|---|
| 맥 최신판 | 4.2.19 (2026년 7월 30일) |
| 맥 파일 | Sourcetree_4.2.19_317.zip · 67.9MB |
| 맥 요구 사항 | macOS 10.15 이상 |
| 윈도우 최신판 | 3.4.32 (2026년 8월 28일) |
| 윈도우 파일 | SourceTreeSetup-3.4.32.exe · 24.1MB |
| 윈도우 내장 Git | Git 2.51.0 · Git LFS 3.7.0 |
두 판 모두 무료입니다. 공식 누리집 첫 화면에는 맥판 다운로드 버튼과 ‘Also available for Windows’ 링크가 함께 있습니다. 한국어 페이지(/ko/)도 있습니다.
윈도우판은 3.4.25부터 Git 2.51.0과 Git LFS 3.7.0을 내장했습니다. 3.4.8부터는 .NET Framework 4.8 기반입니다.
윈도우판 최신 3.4.32에서는 OAuth 갱신 토큰 회전 지원과 윈도우 자격 증명 관리자에 저장된 큰 토큰 처리가 추가됐고, 같은 이름의 폴더를 가진 저장소 두 개를 동시에 열지 못하던 문제가 고쳐졌습니다. 맥판 4.2.19에서는 Mercurial 연결에 TLS 1.2 이상을 강제하도록 바뀌었습니다.
Sourcetree 설치 순서와 첫 설정
공식 설치 안내의 순서입니다.
- Sourcetree 누리집에서 다운로드 버튼을 누릅니다.
- 윈도우는 EXE, 맥은 ZIP을 풀어 나온 앱을 실행합니다.
- 아틀라시안 고객 계약에 동의하고 Continue 를 누릅니다.
- 아틀라시안 계정으로 로그인합니다. 계정이 없으면 Go to My Atlassian 에서 만듭니다.
- 원격 호스팅 서비스를 쓰려면 기본 옵션 그대로 계정 정보를 넣습니다.
- 저장소를 바로 복제할 준비가 안 됐으면 Skip Setup 을 누릅니다.
| 상황 | 방법 |
|---|---|
| 계정 | 아틀라시안 계정 (설치 안내 기준) |
| SSH 키 단계에서 막힘 | HTTPS 선택 후 계속 |
| 복제 준비 전 | Skip Setup |
| 새로 시작 | 로컬 저장소 만들기 |
| 이미 있는 저장소 | 로컬 저장소 추가 |
| 원격 저장소 | 계정 연결 후 복제 |
설치 안내는 저장소를 쓰는 방법을 세 갈래로 나눕니다. 처음 시작하면 컴퓨터에 새 저장소를 만들고, 이미 있는 저장소는 추가해서 보고, 원격 저장소는 계정을 연결한 뒤 내 컴퓨터로 복제합니다.
Sourcetree 원격 계정 연결 — HTTPS와 SSH
원격 저장소를 쓰려면 호스팅 서비스 계정을 Sourcetree에 연결합니다.
- 더보기(•••)를 누르고 Accounts 를 고릅니다.
- Accounts 탭에서 Add 를 누릅니다.
- Host 를 고르고 호스팅 정보를 넣습니다.
- Auth Type 은 기본값 그대로 두고 Connect Account 를 눌러 자격 증명을 넣습니다.
- HTTPS와 SSH 가운데 연결 방식을 고릅니다.
| 방식 | 내용 |
|---|---|
| HTTPS | 자격 증명(앱 비밀번호·토큰)으로 연결 |
| SSH | SSH 키를 먼저 만들어 등록해야 함 |
| SSH 키 단계에서 막힐 때 | HTTPS로 바꿔 계속 (공식 안내) |
| SSH 안내 | 공식 문서 ‘Set up an SSH key’ |
| 계정 수 | 여러 개 추가 가능 |
| 윈도우 SSH 에이전트 | 외부 ssh-agent 쓰면 AutoStartSSHAgent 끄기 (3.4.32) |
윈도우판 3.4.32 릴리스 노트에는 OpenSSH를 쓰면서 외부 ssh-agent 를 쓸 수 있도록 AutoStartSSHAgent 를 끌 수 있게 고쳤다는 항목이 있습니다. 3.4.24에서는 SSH-Agent.exe 가 CPU를 많이 쓰던 문제가 고쳐졌습니다.
Sourcetree 비밀번호 인증 오류 — 앱 비밀번호·API 토큰
원격 연결에서 가장 많이 막히는 지점입니다. 계정 비밀번호를 그대로 넣으면 인증이 실패합니다.
| 판 | 바뀐 점 |
|---|---|
| 윈도우 3.4.15 | Bitbucket 비밀번호 인증 폐지 → 앱 비밀번호 사용 |
| 윈도우 3.4.24 | API 토큰 인증 지원 추가 |
| 맥 4.2.13 | Bitbucket API 토큰 지원 (Git·REST API) |
| 윈도우 3.4.32 | OAuth 갱신 토큰 회전 지원 |
| 계정 비밀번호 | 인증에 쓰지 않음 |
| 넣을 것 | 호스팅 서비스에서 발급한 앱 비밀번호·토큰 |
윈도우판 3.4.15 릴리스 노트에는 ‘Bitbucket 기본 인증이 비밀번호로 실패한다’는 문제가 ‘비밀번호는 이제 폐지됐으니 앱 비밀번호를 쓰라’는 설명과 함께 올라 있습니다. 같은 판에서 Bitbucket Server 계정을 추가할 때 앱 비밀번호를 묻던 문제도 고쳐졌습니다.
그 뒤 윈도우판 3.4.24(2025년 7월)와 맥판 4.2.13에서 API 토큰 인증이 들어갔습니다. 인증이 실패하면 계정 비밀번호 대신 호스팅 서비스 설정에서 발급한 토큰을 넣습니다.
Sourcetree 기업용 설치와 이전 판 받기
회사에서 여러 컴퓨터에 깔 때는 Windows Enterprise판을 씁니다.
| 구분 | 내용 |
|---|---|
| 설치 파일 | MSI (SourcetreeEnterpriseSetup_3.4.32.msi 등) |
| 설치 폴더 | 지정 가능 |
| 조용한 설치 | 지원 |
| 업데이트 | 배포 시점을 회사가 중앙에서 관리 |
| 로그인 | 별도 가입 없이 Bitbucket Data Center 자격 증명 |
| 이전 판 | 다운로드 보관함 (옛 판은 지원 안 될 수 있음) |
Enterprise판은 컴퓨터 관리 소프트웨어로 조직 전체 윈도우 PC에 설치·업데이트를 배포하기 위한 판입니다. 화면과 기능은 일반판과 같다고 공식 페이지가 설명합니다.
새 판에서 문제가 생기면 누리집 아래 ‘Download archive’에서 이전 판을 받을 수 있습니다. 맥은 1.9.8부터, 윈도우는 3.4.18 이후 판이 크기와 날짜, 릴리스 노트와 함께 올라 있습니다. 다만 보관함 페이지는 옛 판이 더 이상 지원되지 않을 수 있다며 수명 종료 정책을 보라고 안내합니다. 엔터프라이즈 MSI도 판별로 같은 보관함에 있습니다.
Sourcetree 주요 기능과 보안 업데이트
공식 누리집이 소개하는 주요 기능입니다.
| 기능 | 내용 |
|---|---|
| 저장소 종류 | Git, Mercurial |
| 스테이징 | 파일·덩어리(hunk)·줄 단위로 스테이징·되돌리기 |
| 대용량 파일 | Git LFS |
| 브랜치 전략 | Git-flow 기본 지원 |
| 고급 기능 | 대화형 리베이스, 스태시, 체리픽, 서브모듈 |
| 검색 | 커밋·파일 변경·브랜치 검색 |
윈도우판 3.4.24부터는 선택하거나 스테이징한 파일만 골라 스태시할 수 있습니다.
윈도우판 릴리스 노트에는 악성 Mercurial 저장소를 열거나 복제할 때 임의 코드가 실행될 수 있던 취약점을 고친 이력이 여러 번 올라 있습니다. 내장 압축 도구와 Git, Git LFS도 보안 문제 때문에 여러 차례 판을 올렸습니다.
원격 저장소 관리 화면에서는 연결한 계정의 원격 저장소를 검색하고 바로 복제할 수 있습니다.
Sourcetree 자주 묻는 질문
Q. Sourcetree는 무료인가요?
무료입니다. 아틀라시안이 맥판과 윈도우판을 모두 무료로 배포하고, 회사에서 여러 대에 까는 Windows Enterprise판(MSI)도 무료로 받을 수 있습니다.
Q. Sourcetree에서 비밀번호를 넣어도 인증이 안 돼요.
윈도우판 3.4.15 릴리스 노트에 Bitbucket의 비밀번호 인증이 폐지돼 앱 비밀번호를 써야 한다고 적혀 있습니다. 이후 판에서는 API 토큰 인증도 지원하므로 계정 비밀번호 대신 발급받은 토큰을 넣습니다.
Q. Sourcetree 맥판은 어떤 macOS에서 되나요?
최신 4.2.19는 macOS 10.15 이상이 필요합니다. 맥판은 ZIP 파일(67.9MB)로 받아 압축을 풀어 실행합니다.
Q. Sourcetree 설치 중 SSH 키 단계에서 넘어가지 못해요.
공식 설치 안내는 SSH 키를 만들지 못해 계속할 수 없으면 HTTPS를 고르고 진행하라고 적고 있습니다. SSH를 쓰려면 공식 문서 ‘Set up an SSH key’를 따라 키를 먼저 만듭니다.
Q. Sourcetree 이전 판은 어디서 받나요?
누리집 아래 ‘Download archive’ 페이지에서 받습니다. 판별 크기·날짜와 릴리스 노트가 함께 있지만, 옛 판은 더 이상 지원되지 않을 수 있다고 적혀 있습니다.
Sourcetree는 맥판과 윈도우판의 번호가 다릅니다. 맥판 최신은 4.2.19로 macOS 10.15 이상이 필요하고, 윈도우판 최신은 3.4.32로 Git 2.51.0과 Git LFS 3.7.0을 내장했습니다. 설치 후 원격 저장소를 연결할 때 계정 비밀번호를 넣으면 인증이 실패할 수 있으니, 릴리스 노트 안내대로 앱 비밀번호나 API 토큰을 넣습니다. SSH 키 단계에서 막히면 HTTPS로 바꿔 계속하고, 저장소 복제가 아직이면 Skip Setup 으로 넘어갑니다. 회사에서 여러 대에 깔 때는 MSI를 쓰는 Windows Enterprise판을, 새 판에 문제가 있으면 다운로드 보관함의 이전 판을 씁니다.