+1
Daily
9,083
stars
386
forks
37
watchers
1,206
prs
3,249
issues
233
releases
README
Bottles
Run Windows Software on Linux
Documentation ·
Forums ·
Discord ·
Funding
!Bottles Dark!Bottles Light
Installation
Contributing
Refer to the Contributing page.
Building
⚠️ Be sure to backup all your data before testing experimental builds of Bottles!
Use the development manifest in this repository when working on Bottles. To build a stable release locally, use the manifest maintained by Flathub.
Development Flatpak
1. Install org.flatpak.Builder from Flathub
2. Clone https://github.com/bottlesdevs/Bottles.git (or your fork)
3. Run flatpak run org.flatpak.Builder --install --install-deps-from=flathub --default-branch=master --force-clean build-dir build-aux/com.usebottles.bottles.Devel.json in the terminal from the root of the repository (use --user if necessary)
4. Run flatpak run com.usebottles.bottles.Devel to launch it
Release Flatpak
The authoritative manifest for the stable package is maintained in the Flathub repository. It defines the Bottles source, dependencies, runtime, and permissions used for each release.
1. Install org.flatpak.Builder from Flathub
2. Clone https://github.com/flathub/com.usebottles.bottles.git
3. Run the following command from the root of the cloned repository:
shell
flatpak run org.flatpak.Builder \
--user \
--install \
--install-deps-from=flathub \
--default-branch=local \
--force-clean \
build-dir \
com.usebottles.bottles.yml
4. Run flatpak run com.usebottles.bottles//local to launch it
The local branch is installed alongside the Flathub branch. Both use the same application ID and Bottles data directory, so changes made by either build affect the other. To build an older release, use git log -- com.usebottles.bottles.src.yaml to find and check out its Flathub commit before running the build command.
Meson
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 run flatpak install bottles.flatpak (use --user if necessary)
2. Run flatpak run -d --filesystem=$PWD --command=bash com.usebottles.bottles.Devel from the root of the repository, followed by ./build-aux/install.sh. This will build Bottles and install it under the build/ directory.
3. Run ./build/bin/bottles to launch Bottles
Due to GNOME Builder limitations, Builder cannot build Bottles for the time being; see GNOME/gnome-builder2061 for more context. This is the best workaround we can provide.
Code of Conduct
This project follows the GNOME 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.
Use of Generative AI
Some maintainers use generative AI tools as assistants while working in Bottles, in the spirit of Open SouTop issues
#4924[Bug]: Bottles app doesn't open anymore8 comments · 2026-10-31#4828[Bug]: UEVR + WiVRn works when launched manually, but fails when launched from Bottles GUI8 comments · 2026-09-15#4934[Bug]: dotnet48/dotnet40 dependency fails on 67.6 right after get_windows_version (64-bit bottle)3 comments · 2026-11-09#4922[Bug]: Synchronization setting doesn't do anything3 comments · 2026-10-31#4941msi afterburner works on bottles or a similer program2 comments · 2026-11-14#4928[Bug]: UMU executable path is cleared with separate game and prefix directories2 comments · 2026-11-04#4919[Bug]: Bottle creation fails with "Wine prefix initialization failed" on all runners while manual wineboot succeeds2 comments · 2026-10-29#4921Missing 'App preferences' page in document.1 comments · 2026-10-30
Discussions
#4938Bottles is not fetching new Kron4ek runners1 comments · 2026-11-10#4916Symbolic link doesn't work anymore1 comments · 2026-10-28#4907Trying to install The Elder SCrolls IV: Oblivion Game of the Year Edition in bottles along with a MOD manager.23 comments · 2026-10-24#4899Did you see what happening with Sony, Nintendo, Adobe and e.t.c?0 comments · 2026-10-19#4890How to use VR with bottles?0 comments · 2026-10-14#4873How Do I Install Microsoft Office to a Bottle?1 comments · 2026-10-09#4871The Bottles can not connect the internet1 comments · 2026-10-07#4870unable to create a bottle with flatpak1 comments · 2026-10-06
Latest release
67.6 67.6 2026-11-04What's Changed Added bottle moves between directories and a destination picker when duplicating bottles. Added per-bottle notes and library sorting by bottle name. Added Default, Application and System DPI scaling modes in Advanced Display Settings. Added optional UMU controls, support for launch wrappers and download status in the library. Added a playtime reset button and warnings for missing program files without removing shortcuts. Fixed interrupted downloads on slow connections with a longer read timeout and bounded retries. Fixed startup delays, repeated Battle.net launches and sa