Skip to content

Installation

BenJule edited this page May 31, 2026 · 1 revision

Installation

All installation methods deliver the same BambuStudio binary. Choose the method that best fits your platform and update preferences.


Linux

APT Repository (Debian / Ubuntu) — Recommended

The APT repository at apt.s3-dev.ovh provides automatic updates via apt upgrade.

Supported distributions: Debian 12+, Ubuntu 22.04 LTS, Ubuntu 24.04 LTS

# 1. Import the signing key
curl -fsSL https://apt.s3-dev.ovh/KEY.gpg \
  | sudo gpg --dearmor -o /etc/apt/trusted.gpg.d/bambustudio.gpg

# 2. Add the repository
echo "deb [signed-by=/etc/apt/trusted.gpg.d/bambustudio.gpg] https://apt.s3-dev.ovh stable main" \
  | sudo tee /etc/apt/sources.list.d/bambustudio.list

# 3. Install
sudo apt update && sudo apt install bambu-studio

Update:

sudo apt upgrade bambu-studio

Remove:

sudo apt remove bambu-studio
sudo rm /etc/apt/sources.list.d/bambustudio.list
sudo rm /etc/apt/trusted.gpg.d/bambustudio.gpg

AUR (Arch Linux)

yay -S bambu-studio-bin

Any AUR helper works: paru, trizen, aurutils, etc. The -bin package installs the pre-built binary — no compilation required.

Update:

yay -Syu bambu-studio-bin

AppImage (any Linux distro)

AppImages are self-contained and require no installation. Ubuntu 22.04 and 24.04 AppImages are built nightly.

  1. Download the latest .AppImage from the releases page
  2. Make it executable and run:
chmod +x BambuStudio_*.AppImage
./BambuStudio_*.AppImage

Tip

Use AppImageLauncher to integrate AppImages into your desktop environment.


Flatpak

flatpak install flathub com.bambulab.BambuStudio
flatpak run com.bambulab.BambuStudio

Note

The Flathub version is maintained by the upstream Bambu Lab community. This fork's Flatpak is built from our release artifacts and attached to each release.


.deb Package (manual)

# Download from releases page, then:
sudo dpkg -i bambustudio_*.deb
sudo apt-get install -f          # resolve any missing dependencies

.rpm Package (Fedora / openSUSE)

# Fedora
sudo dnf install ./bambustudio-*.rpm

# openSUSE
sudo zypper install ./bambustudio-*.rpm

macOS

Homebrew (Recommended)

brew tap BenJule/homebrew-tap
brew install --cask bambu-studio

Update:

brew upgrade --cask bambu-studio

Supported: macOS 13 Ventura and later, Intel and Apple Silicon (universal binary).


DMG Installer

  1. Download the latest .dmg from the releases page
  2. Open the .dmg and drag BambuStudio to /Applications

Note

On first launch macOS may show a security prompt. Go to System Settings → Privacy & Security and click Open Anyway.


Windows

winget (Recommended)

winget install BenJule.BambuStudio

Update:

winget upgrade BenJule.BambuStudio

Supported: Windows 10 (1903+) and Windows 11, x64 and ARM64.


Installer (EXE)

  1. Download the latest .exe installer from the releases page
  2. Run the installer and follow the setup wizard

Both x64 and ARM64 installers are provided.


Verifying Downloads

Release artifacts are signed with GPG. To verify:

# Import the release signing key (from the releases page)
gpg --import bambu-release-key.asc

# Verify the artifact
gpg --verify BambuStudio_*.AppImage.sig BambuStudio_*.AppImage

SHA-256 checksums are listed in each release's description.


Nightly Builds

Nightly pre-releases are published daily at approximately 02:00–04:00 UTC from the latest master commit. They are useful for testing recent fixes before an official release.

Warning

Nightly builds may be unstable. Do not use them in a production workflow. A 14-day rolling history is kept; older nightlies are automatically deleted.

Find nightlies under Releases — they are tagged nightly-YYYYMMDD-<sha> and marked as Pre-release.


Troubleshooting Installation

See Troubleshooting for common installation issues.

Clone this wiki locally