github desktop: switch from Sourcetree

Many Windows users type Git client names after years on Sourcetree. Switching means installing github desktop from official doors, pointing it at the clone folders you already keep, and rebuilding a few habits. Atlassian bookmarks do not travel automatically.

Install the new client first

Keep Sourcetree running until you prove one push in the new window if you still have active work. Install via GitHubDesktopSetup-x64.exe or winget install -e --id GitHub.GitHubDesktop. Mac users can use brew install --cask github.

Windows detail: Windows install. Safe doors: download safely.

winget install -e --id GitHub.GitHubDesktop

Move repositories and folders

Use File → Add Local Repository and point at existing clone directories. You may also File → Clone Repository for remotes you still need from GitHub.com. Labels and custom tabs usually need to be recreated by hand. There is no perfect one-click importer for every Sourcetree bookmark.

What does not transfer

Atlassian account preferences, Sourcetree-specific tools panes, and some nested repository views stay behind. SSH keys already in the OS agent continue to work. Embedded Git versions differ; confirm Help → About after install.

Prove the cutover

1. Pause busy pushes in Sourcetree. Avoid two clients fighting the same index.
2. Add one local repository. Confirm the branch list looks right.
3. Commit a tiny change. Prove the Git integration.
4. Push to a known remote. Confirm credentials.
5. Uninstall Sourcetree when ready. After a quiet week of stable work.

Why people switch

Common reasons include wanting the official GitHub client, preferring MIT source, or standardising labs on one free binary. GitKraken is another GUI option with a different licence model; compare at github desktop vs Sourcetree.

Quiet checklist for the next image

• Pin the Releases URL and package ids on the lab card.
• Prove one commit or clone after every reimage.
• Keep adware mirrors off the bookmark bar.
• Record whether winget, brew, or a manual asset was used.
• Reboot once before you call the desk ready.

Trainers rehearse the prove step on a small trusted repository. Helpdesks ask for the filename and the Options path before they escalate. Travel kits carry the same notes on paper when Store access is flaky.

When a machine retires, uninstall the client and clear clone folders that still hold private work according to your retention rules. Keep signature verification optional for threat models that require checksums from the same tag.

Shared apartments and coworking desks should document which OS user owns the GitHub.com session. Two people sharing one Windows profile will collide on remotes and signed commits. Separate OS accounts keep github desktop identity maps honest.

Firewall and proxy environments need an explicit note about HTTPS remotes versus SSH. The client can use either once credentials exist, but imaging docs should pick one default so substitutes do not guess under pressure.

Publishers who rename Setup.exe for faster mirrors break SmartScreen reputation. Teach volunteers to compare filenames against Releases before they click through warnings.

Operational detail for shared desks

Shared desks drift when every volunteer picks a different mirror. Print the GitHub Releases URL, the winget id GitHub.GitHubDesktop, and the Homebrew cask github on the same lab card. After each reimage, prove one commit before you hand the machine back.

Prefer returning to the documented door even when search ads shout louder than the official project name. Helpdesk tickets move faster when they include the OS build, the asset name or package id, and whether a VPN changed during the incident.

Vague git-is-broken notes waste mornings. Ask for a screenshot of the repository list and the account pane in Options. Classroom images should freeze only after a reboot test.

Back to the pillar: github desktop home. Guides: guides.

Support rhythms that age well

Helpdesks move faster when every ticket names the installer door and the Windows build together. Vague reports that only say git feels wrong waste a day. Ask for the filename or winget id, the approximate install date, and whether GitHub.com sign-in changed during the complaint.

• Keep a spare USB with the current GitHubDesktopSetup-x64.exe for rooms without winget.
• Use a quiet prove-one-commit step before demoing a huge monorepo.
• Inventory GitHub tokens separately from the desktop binary.
• Pin one update door per lab image.

A forgotten GitHub password looks like a broken client. Tag hardware notes with the matching Options path so substitutes do not guess under pressure. When imaging season arrives, freeze the golden machine only after a reboot test.

Internal runbooks should quote the winget id, the brew cask, and the Releases URL without marketing adjectives. Staff skim under stress. A short checklist with five boxes outperforms a three-page essay that nobody finishes.