Skip to content

installation.md

Latest commit

 

History

History
123 lines (82 loc) · 3.06 KB

installation.md

File metadata and controls

123 lines (82 loc) · 3.06 KB

Installation

Using the AppImage

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:

./Bottles-*-x86_64.AppImage

Install the Appimage

At the first launch, Bottles asks you if you want to install the AppImage, this will make it available in the applications menu of the Desktop Environment in use:

Flatpak

Flathub

We have requested to join the Flathub online repository. More info here. When our request is accepted, we will update this page with the installation steps.

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 bottles-source.zip https://github.com/bottlesdevs/Bottles/archive/master.zip
unzip bottles-source.zip
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.

Arch Linux

There are two packages from AUR for Arch Linux:

  • bottles-git (which offers the latest version from our git repository)
  • bottles (which should be the latest stable version)

To install one of these packages use an AUR helper like yay or paru:

yay -S bottles-git

or manually using makepkg:

git clone https://aur.archlinux.org/packages/bottles-git
cd bottles-git
makepkg -si

Fedora & Open suse (Tumbleweed)

The latest rpm package ca be found in this repository and can be installed double clicking on it (in most distributions) or by terminal using the rpm command:

$ rpm -i package_name.rpm

Build from source

You can also build Bottles from source.

Requirements:

  • meson
  • ninja
  • python3
  • glib
    • glib2-devel on Fedora
    • libglib2.0-dev on Debian/Ubuntu
  • python3 patool (runtime)
  • python3 markdown (runtime)
  • libhandy (runtime)

Clone Bottles from GitHub:

git clone https://github.com/bottlesdevs/Bottles.git
cd Bottles

and build using meson and install using ninja:

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