Installation

slackner edited this page Jan 10, 2016 · 34 revisions

Ready-to-use packages for Wine Staging are available for a variety of Linux distributions and for Mac OS X. Just follow the installation instructions for your operating system below. If your distribution is not listed below, feel free to add a feature request - if the demand is high enough we might consider packaging it for additional distributions. Alternatively, you can compile Wine Staging as described on our Packaging site.

Remark: For historical reasons and to allow testing of Staging and non-Staging Wine versions in parallel the packages will be installed to /opt/wine-staging/. If you want to use Wine Staging as your main wine version without having to type the full path each time, it is recommended to install the winehq-staging package which adds compatibility symlinks.

Distributions

Arch Linux

Arch Linux provides Wine Staging in the official multilib repositories. You can install the package using:

$ sudo pacman -Syu wine-staging

Unlike our previous self created wine-staging package, the official package installs all files under /usr and therefore conflicts with other wine versions. If you want to install wine-staging somewhere else, please modify the PKGBUILD file accordingly and rebuild the package.

Debian Wheezy/Jessie/Stretch/Sid

In order to install i386 packages on a 64-bit system, you have to run the following command as a first step:

$ sudo dpkg --add-architecture i386

Afterwards import the key for our repository:

$ wget https://repos.wine-staging.com/Release.key
$ sudo apt-key add Release.key

And add our repository at the end of your /etc/apt/sources.list file:

# For Debian Wheezy add the following line:
deb https://repos.wine-staging.com/debian/ wheezy main

# For Debian Jessie this one:
deb https://repos.wine-staging.com/debian/ jessie main

# For Debian Stretch this one:
deb https://repos.wine-staging.com/debian/ stretch main

# And for Debian Sid this one:
deb https://repos.wine-staging.com/debian/ sid main

Afterwards update the package cache and install it:

$ sudo apt-get update
$ sudo apt-get install wine-staging

If you want to avoid typing the full path each time you can additionally install the winehq-staging package which provides compatibility symlinks:

$ sudo apt-get install winehq-staging

For more information about how to use Wine Staging please refer to our Usage Wiki page.

Fedora

Note: Fedora ships Wine Staging as the default version. There should be no need to use this packages, except support is removed again in the future, or the version provided by Fedora is not new enough. Check with wine --version and wine --patches to find out if your version has any patches applied or not. When the version already ends with (Staging) there is no need to do anything and you can use Wine Staging out of the box.

The version provided in our own Fedora repository will install to /opt/wine-staging/ and does not replace the regular Wine version. You can replace your normal wine version by installing the winehq-staging package.

The following commandline adds our repository to your system:

# For Fedora 22
dnf config-manager --add-repo https://repos.wine-staging.com/fedora/22/wine-staging.repo

# For Fedora 23
dnf config-manager --add-repo https://repos.wine-staging.com/fedora/23/wine-staging.repo

Afterwards run the following command to install the package:

# For installation in /opt/wine-staging
dnf apt-get install wine-staging

# As default wine version
dnf apt-get install winehq-staging

For more information about how to use Wine Staging please refer to our Usage Wiki page.

Gentoo (Portage)

In current versions of Wine all Staging features can be easily enabled by selecting the "staging" USE flag and (re)compiling the Wine version. Please note that the USE flag was renamed some time ago, in older Wine versions a similar functionality is available with the "pipelight" USE flag.

# echo "app-emulation/wine staging" >> /etc/portage/package.use
# emerge -av app-emulation/wine

For more information about how to use Wine Staging please refer to our Usage Wiki page.

Gentoo (Layman)

Wine is also available via the wine-overlay https://github.com/NP-Hardass/wine-overlay which is managed by a gentoo user, NP-Hardass. The ebuilds available in this overlay feature a number of bugfixes and improved dependency handling. This overlay also provides bleeding edge wine support, including a fully functional live ebuild. Any bugs regarding the ebuild should be filed on the wine-overlay Github issue tracker.

These instructions assume that you have a functional layman setup. If you do not have layman setup, see Gentoo Wiki: Layman

Once you have layman working, you want to fetch and add wine-overlay.

# layman -o https://raw.githubusercontent.com/NP-Hardass/wine-overlay/master/overlay.xml -f -a wine-overlay

The ebuilds in wine-overlay have several USE flags of note:

  • staging enables Wine Staging
  • pipelight enables Pipelight support
  • s3tc enables S3 Texture Compression
  • pulseaudio enables PulseAudio support

Once you've chosen your USE flags, let's tell Portage, and emerge. For example:

# echo "app-emulation/wine staging pipelight" >> /etc/portage/package.use
# emerge -av app-emulation/wine::wine-overlay

For more information about how to use Wine Staging please refer to our Usage Wiki page.

Mageia 4/5

As a first step please add the key for our repository

# wget https://repos.wine-staging.com/Release.key
# rpm --import Release.key

If you're using a 32-bit version of Mageia just add the repository for 32-bit packages:

# If you are using 32-bit Mageia 4
$ sudo urpmi.addmedia "Wine Staging 32-bit" https://repos.wine-staging.com/mageia/4/i586/

# If you are using 32-bit Mageia 5
$ sudo urpmi.addmedia "Wine Staging 32-bit" https://repos.wine-staging.com/mageia/5/i586/

For a 64-bit version of Mageia you'll need both the 32-bit and the 64-bit repository:

# If you are using 64-bit Mageia 4
$ sudo urpmi.addmedia "Wine Staging 32-bit" https://repos.wine-staging.com/mageia/4/i586/
$ sudo urpmi.addmedia "Wine Staging 64-bit" https://repos.wine-staging.com/mageia/4/x86_64/

# If you are using 64-bit Mageia 5
$ sudo urpmi.addmedia "Wine Staging 32-bit" https://repos.wine-staging.com/mageia/5/i586/
$ sudo urpmi.addmedia "Wine Staging 64-bit" https://repos.wine-staging.com/mageia/5/x86_64/

Afterwards run the following commands to install the package:

$ sudo urpmi.update -a
$ sudo urpmi wine-staging

There is currently no compatibility symlinks package available yet for Mageia, so make sure to type always the full path /opt/wine-staging/bin/wine in order to run Wine Staging. For more information about how to use Wine Staging please refer to our Usage Wiki page.

OpenSUSE

We do no longer build Wine Staging packages for OpenSUSE on our own, instead Marcus Meissner takes care of this. You can install the packages as described below.

openSUSE version Path component
openSUSE 12.2 /openSUSE_12.2/
openSUSE 12.3 /openSUSE_12.3/
openSUSE 13.1 /openSUSE_13.1/
openSUSE 13.2 /openSUSE_13.2/
openSUSE Factory /openSUSE_Factory/
openSUSE Tumbleweed /openSUSE_Tumbleweed/
openSUSE Leap 42.1 /openSUSE_Leap_42.1/

The following commandline is an example for openSUSE 13.1, for a different version just replace the path component according to the table above:

# zypper ar --refresh http://download.opensuse.org/repositories/Emulators:/Wine/openSUSE_13.1/Emulators:Wine.repo

Afterwards just run the following commands to install it:

# zypper ref
# zypper install wine-staging

Please note that the package replaces your regular Wine version unlike the other packages provided directly by us.

Ubuntu/Linux Mint

Please run the following commands from a terminal, one line after each other.

$ sudo add-apt-repository ppa:wine/wine-builds
$ sudo apt-get update
$ sudo apt-get install --install-recommends wine-staging

If you want to avoid typing the full path each time you can additionally install the winehq-staging package which provides compatibility symlinks:

$ sudo apt-get install winehq-staging

Mac OS X

Starting with Wine Staging 1.7.46 we provide prebuilt packages for Mac OS X 10.8+. Those packages should be considered as beta version for now. They contain only the Wine files including the native winemac driver (+ dependencies), but no graphical tools for Wine prefix management. For now it is necessary to manually download and install the new package on each new release. We might implement an auto updater in the future.

In order to use the package, you first need to install XQuartz 2.7.7 or higher. This is necessary because various binaries are linked against libraries from the XQuartz package. To install Wine Staging simply grab the latest .pkg from our repository and run the installer. It is possible to install the package either for all users (needs administrator privileges), or just for your current user. After the installation is finished, you should find an entry "Wine Staging" in your Launchpad. By clicking on it, a new Terminal window opens with a short introduction. It is recommended to run wine --check-libs after the installation to make sure that all necessary dependencies can be found (except libnetapi and libodbc which are not essential). You can now directly start wine/winecfg/... from the Terminal, as the $PATH variable is set correctly. For user convenience, the package also associates itself with all *.exe files, which means you can run windows executables just by double-clicking on them.

For more information about how to use Wine Staging please refer to our Usage Wiki page.