← Help Center · Linux desktop

Install Bucket Browser on Linux

Linux desktop is currently a prerelease. These packages are intended for testing. Check that your websites and family settings work as expected before everyday use.

Before you start

Packages are available for Debian 13 on amd64 (x86-64) and ARM64. Use an X11 desktop, or a Wayland desktop with XWayland. Other Linux distributions have not been qualified for this release.

You will need administrator access to install software. Adding the repository below also enables future Linux prerelease updates.

1. Enable HTTPS downloads

Open Terminal and install these tools if they are not already available:

sudo apt-get update
sudo apt-get install curl ca-certificates

2. Add the Bucket Browser repository once

This installs the repository’s public signing key and APT source configuration. Debian does not include this repository by default.

download_dir="$(mktemp -d)"
curl -fsSLo "$download_dir/bucket-browser.gpg" https://packages.bucketbrowser.app/bucket-browser.gpg
curl -fsSLo "$download_dir/bucket-browser.sources" https://packages.bucketbrowser.app/bucket-browser.sources
sudo install -d -m 0755 /etc/apt/keyrings
sudo install -m 0644 "$download_dir/bucket-browser.gpg" /etc/apt/keyrings/bucket-browser.gpg
sudo install -m 0644 "$download_dir/bucket-browser.sources" /etc/apt/sources.list.d/bucket-browser.sources

3. Install the desktop app

sudo apt-get update
sudo apt-get install bucket-browser-desktop

The matching shared core and required system libraries are installed automatically. You do not need to install .NET separately.

4. Open Bucket Browser

Choose Bucket Browser from your desktop’s application menu, or run bucket-browser in Terminal. Follow the welcome screens to sign in and set up your family.

When prompted to set up or unlock secure sign-in, follow the in-app steps. Saved credentials are kept in your Linux user’s encrypted keyring.

Get updates

Your software manager can offer updates from this repository. To update from Terminal:

sudo apt-get update
sudo apt-get install --only-upgrade bucket-browser-desktop

Need help?

If you use Wayland and the app cannot open its browser view, check that XWayland is installed. For other problems, include your Debian version, architecture and app version when contacting support. Never include passwords, parent PINs or device-pairing codes.

Set up your family · Troubleshooting · Package repository