Installation

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 full-sandboxed version. It bundle all the needed dependencies and tools and works an 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
wgen -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
This is the most tested and updated version ever. It is a portable package that should works on every distribution.
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 non-official packages for installing Bottles on some distributions.
Fedora
Void linux
NixOS
Tumbleweed
MX 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.
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!

Welcome

Next - Getting started

First run

Last modified 8d ago

Copy link

Contents