Repository files navigation

Bottles

Run Windows Software on Linux

---

Documentation ·Forums ·Discord ·Funding

Refer to theContributing page.

⚠️ Be sure to backup all your data before testing experimental builds of Bottles!

There are two methods to build Bottles. The first and longer method is usingorg.flatpak.Builder, and the second but shorter method is building directly.

1. Installorg.flatpak.Builder from Flathub
2. Clonehttps://github.com/bottlesdevs/Bottles.git (or your fork)
3. Runflatpak run org.flatpak.Builder --install --install-deps-from=flathub --default-branch=master --force-clean build-dir com.usebottles.bottles.yml in the terminal from the root of the repository (use--user if necessary)
4. Runflatpak run com.usebottles.bottles//master to launch it

Since Bottles is primarily and officially distributed as a Flatpak, we only provide instructions to directly build it inside a Flatpak environment:

1. Download and install the latest build of Bottles:bottles-x86_64.zip. Unzip it, and runflatpak install bottles.flatpak (use--user if necessary)
2. Runflatpak run -d --filesystem=$PWD --command=bash com.usebottles.bottles//master from the root of the repository, followed by./utils/install.sh. This will build Bottles and install it under thebuild/ directory.
3. Run./build/bin/bottles to launch Bottles

Due to GNOME Builder limitations, Builder cannot build Bottles for the time being; seeGNOME/gnome-builder#2061 for more context. This is the best workaround we can provide.

This project follows theGNOME Code of Conduct. You are expected to follow it in all Bottles spaces, such as this repository, the project's social media, messenger chats and forums. Bigotry and harassment will not be tolerated.