Using the AppImage

This is the most tested and updated version ever.

First you need to download the latest release from our website then, set executable permission to the .AppImage file:

chmod +x Bottles-*-x86_64.AppImage

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:


..or using zap⚡!

zap install bottles



Manual build snap

Download the latest bottles source from GitHub:

wgen -O
cd bottles-source

Install snapcraft, e.g. on Ubuntu 20.04+:

apt install snapcraft

then build, install (using the --dangerous option to skip the checksum) and run:

snap install bottles*.snap --dangerous
snap run bottles


Bottles is available on AUR with 2 different packages:

  • bottles provide the latest stable build

  • bottles-git the latest commit from the GitHub repository

You can install using your preferred AUR helper:

yay -S bottles
paru -S bottles

or manually:

git clone
cd bottles-git
makepkg -si



This package receives a total of 2 monthly updates, scheduled on the 14th and 28th of each month (but may vary in case of mainline release delays).

Download on Flathub


Bottles Flatpak also provide a Beta channel for testing purpose.

Manual build flatpak

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:

wgen -O
cd bottles-source

Build can be performed using flatpak-builder (installable using your distribution package manager like apt, dnf, ..):

flatpak-builder --repo=bottles --force-clean --user build-dir com.usebottles.bottles.yml
flatpak remote-add --user bottles bottles --no-gpg-verify
flatpak install --user bottles com.usebottles.bottles

Then run using flatpak command:

flatpak run com.usebottles.bottles

Unofficial packages

Our community provides non-official packages for installing Bottles on some distributions.


Bottles is available on Fedora repositories thanks to @atim so you can install using dnf:

$ dnf install bottles

Build from source

You can also build Bottles from source.


  • meson

  • ninja

  • python3

  • glib

    • glib2-devel on Fedora

    • libglib2.0-dev on Debian/Ubuntu

Clone Bottles from GitHub:

git clone
cd Bottles

and build using meson and install using ninja:

mkdir build
meson build && cd build
ninja -j$(nproc)
$ ninja install