Installation Guide EN

中文 | English

This page lists every way to get BIT. For the latest version, see Releases. For the detailed support matrix of chip architectures and operating systems, see Chips and OS Support.

Direct Download

Channel	URL	Notes
GitHub Releases	https://github.com/yxpil/bit/releases	Official release page
Website mirror	https://osbt.space	Fastly CDN, no redirects
Gitee mirror	https://gitee.com/yxpil/bit	Fallback for mainland China networks

Package per Platform

Platform	Package	Notes
Windows x64	*-setup.exe (NSIS) or *.msi	Double-click to install
Windows ARM64 (Snapdragon X)	*_arm64-setup.exe	WiX has poor ARM64 support, no MSI
macOS Apple Silicon	*_aarch64.dmg	M-series chips; a *_app.zip portable build is also available
macOS Intel	*_x64.dmg	Drag into Applications
Linux x64 / ARM64	*.deb / *.AppImage / *.rpm	Pick whichever your distro prefers
Loongson LoongArch64 (3A5000/3A6000)	*_loongarch64.deb / *.tar.gz	The deb installs with a double-click; on other distros extract the binary
RISC-V 64 (VisionFive 2, etc.)	*_riscv64.deb / *.tar.gz	Same as above
Phytium / Kunpeng / Kylin ARM	*_arm64.deb / *_arm64.AppImage / *_arm64.rpm	Same packages as Linux ARM64
Zhaoxin / Hygon	*_amd64.deb / *_x86_64.rpm	Same packages as Linux x64

Package Managers

macOS (Homebrew):

brew tap yxpil/bit
brew install --cask bit

Windows (Scoop):

scoop bucket add bit https://github.com/yxpil/scoop-bit
scoop install bit

Windows (winget, under review):

winget install yxpil.bit

npm (cross-platform, automatically downloads the app for your platform):

npm install -g bit-agent
bit-agent   # Launch BIT

Debian / Ubuntu / UOS / Kylin (APT repository):

echo "deb [trusted=yes] https://yxpil.github.io/apt-repo stable main" | sudo tee /etc/apt/sources.list.d/bit.list
sudo apt update && sudo apt install bit

Fedora / RHEL / openSUSE (dnf repository):

sudo tee /etc/yum.repos.d/bit.repo <<'EOF'
[bit]
name=BIT
baseurl=https://yxpil.github.io/dnf-repo
enabled=1
gpgcheck=0
EOF
sudo dnf install bit

Arch / Manjaro (pacman repository):

echo "
[bit]
Server = https://yxpil.github.io/pacman-repo/\$arch
SigLevel = Never" | sudo tee /etc/pacman.d/bit.conf
# Then add a line before [core] in /etc/pacman.conf: Include = /etc/pacman.d/bit.conf
sudo pacman -Sy bit

ChromeOS (Crostini)

ChromeOS ships a built-in Linux development environment (Debian 12 container), and the Linux packages work as-is:

1. Settings → About ChromeOS → Developers → Linux development environment → Enable (supported on both Intel/AMD and ARM devices)
2. Install from the Linux terminal (choose amd64 for Intel/AMD, arm64 for ARM):

sudo apt install ./BIT_0.5.6_amd64.deb

The dependencies (libwebkit2gtk-4.1, libgtk-3, libayatana-appindicator3) are pulled in automatically from the Debian 12 repositories. After installation BIT appears in the "Linux apps" folder.

Installation Issues

macOS says the app is "damaged and can't be opened"

BIT does not purchase an Apple developer certificate and is ad-hoc signed, so apps downloaded from the internet are blocked by default. Pick any one of the following:

Option 1: Remove the quarantine attribute (recommended)

xattr -cr /Applications/BIT.app

Option 2: Allow it in System Settings

Double-click the dmg to install. If a warning pops up on first launch, don't click "Move to Trash" yet; open System Settings → Privacy & Security → the Security section → click "Open Anyway".

Option 3: Open via right-click (macOS 14 or earlier)

Control-click BIT → choose "Open" → click "Open" again to confirm.

Windows shows SmartScreen

The installer is not code-signed. When the prompt appears, just click "More info" → "Run anyway". See FAQ for notes on antivirus false positives.

Running the AppImage on Linux

chmod +x BIT_0.5.6_amd64.AppImage
./BIT_0.5.6_amd64.AppImage