Installation
We offer Bottles in different packages, make your choice!
Bottles is officially provided as AppImage, Flatpak, Snap, AUR, deb package. There are also other packages maintained by our community, like Fedora and AUR (bottles-git).

Flatpak

This is the only fully sandboxed version. It bundles all the needed dependencies and tools and works on all distributions supported by Flatpak.
This is the most supported and tested release of Bottles.
Flathub
Beta
Manual build
Just press the button below:
Bottles Flatpak also provide a Beta channel for testing purpose, maintained by our community. 1. Add the Flathub beta remote:
1
flatpak remote-add --user flathub-beta https://flathub.org/beta-repo/flathub-beta.flatpakrepo
2
flatpak update --appstream
Copied!
2. Then install Bottles:
1
flatpak install --user flathub-beta com.usebottles.bottles
Copied!
We need the following dependencies:
  • org.gnome.Sdk
  • org.gnome.Sdk.Compat.i386
  • org.freedesktop.Sdk.Extension.toolchain-i386
Download the latest bottles source from GitHub:
1
wget -O bottles-source.zip https://github.com/bottlesdevs/Bottles/archive/master.zip
2
unzip bottles-source.zip
3
cd bottles-source
Copied!
Build can be performed using flatpak-builder (installable using your distribution package manager like apt, dnf, ..):
1
flatpak-builder --repo=bottles --force-clean --user build-dir com.usebottles.bottles.yml
2
flatpak remote-add --user bottles bottles --no-gpg-verify
3
flatpak install --user bottles com.usebottles.bottles
Copied!
Then run using flatpak command:
1
flatpak run com.usebottles.bottles
Copied!

AUR

Bottles is available on AUR with 2 different packages:
  • bottles (official) provide the latest stable build
  • bottles-git (unofficial) the latest commit from the GitHub repository
AUR helper
Traditional way
Bottles can be installed using an AUR helper like yay or paru:
1
yay -S bottles # or bottles-git
2
paru -S bottles # or bottles-git
Copied!
1
git clone https://aur.archlinux.org/packages/bottles # or bottles-git
2
cd bottles # or bottles-git
3
makepkg -si
Copied!

AppImage

It is a portable package that should works on every distribution.
The AppImage is broken, we are investigating, please use Flatpak in the meantime.
zap⚡
Traditional way
First install zap, then:
1
zap install bottles
Copied!
First you need to download the latest release from our website then, set executable permission to the .AppImage file:
1
chmod +x Bottles-*-x86_64.AppImage
Copied!
Move the file to a safe path where there is no risk of deleting them and double click on it, or launch via the terminal by typing:
1
./Bottles-*-x86_64.AppImage
Copied!

Other packages

Our community provides unofficial packages for installing Bottles on some distributions.
While we are open to working with package maintainers from all sorts of Linux distributions to deliver the best possible experience of using Bottles, we are not responsible for the quality of the unofficial packages.
Please report any issues experienced when using the packages to their respective maintainers.
Fedora
Void Linux
NixOS
Tumbleweed
MX Linux
OpenMandriva
ALT Linux
Build from source
Bottles is available on Fedora repositories thanks to @atim so you can install using dnf:
1
dnf install bottles
Copied!
Bottles will be available soon on Void Linux thanks to @andry-dev. Read more here.
Bottles is available on NixOS repositories thanks to @bloomvdomino so you can install it using nix-env:
1
nix-env -iA nixos.bottles
Copied!
The package for openSUSE Tumbleweed can be obtained from the official games:tools repository.
This package is maintained by @SwampRabbit and can currently be installed on MX-21 by using MX Package Installer - MX Test Repo tab. Package status thread is here.
Bottles is available on OpenMandriva repositories and can be installed using the dnf tool:
1
dnf install bottles
Copied!
Bottles is available on ALT Linux Sisyphus repository. You can install the package using the apt-get tool provided by the system:
1
apt-get install bottles
Copied!
Requirements:
  • meson
  • ninja
  • python3
  • glib
    • glib2-devel on Fedora
    • libglib2.0-dev on Debian/Ubuntu
Clone Bottles from GitHub:
1
git clone https://github.com/bottlesdevs/Bottles.git
2
cd Bottles
Copied!
and build using meson and install using ninja:
1
mkdir build
2
meson build && cd build
3
ninja -j$(nproc)
4
ninja install
Copied!
Export as PDF
Copy link
Edit on GitHub