Chapter 1. Introduction

Table of Contents
1.1. Overview / About
1.2. What is Wine?
1.3. Versions of Wine
1.4. Alternatives to Wine you might want to consider

1.1. Overview / About

1.1.1. Purpose of this document and intended audience

This document, called the Wine User Guide, is both an easy installation guide and an extensive reference guide. This guide is for both the new Wine user and the experienced Wine user, offering full step-by-step installation and configuration instructions, as well as featuring extensive reference material by documenting all configuration features and support areas.

1.1.2. Further questions and comments

If, after examining this guide, the FAQ, and other relevant documentation there is still something you cannot figure out, we would love to hear from you. The mailing lists section contains several mailing lists and an IRC channel, all of which are great places to seek help and offer suggestions. If you are particularly savvy, and believe that something can be explained better, you can file a bug report or post a patch on Wine's documentation itself.

1.1.3. Content overview / Steps to take

In order to be able to use Wine, you must first have a working installation. This guide will help you to move your system from an empty, Wineless void to one boasting a fresh, up to date Wine install. The first step, Getting Wine, illustrates the various methods of getting Wine's files onto your computer. The second step, Configuring Wine, shows how to customize a Wine installation depending on your individual needs. The final step, Running Wine, covers the specific steps you can take to get a particular application to run better under Wine, and provides useful links in case you need further help.

1.1.4. Quick start

The process of installing and running wine can be summarised as follows:

  • Get a distribution as indicated in Getting Wine and see the Wine Downloads page. For the casual or new user the simplest is to get an rpm distribution.

  • Configure wine using the winecfg command. For most people wine should now be usable.

  • To test your installation run wine's Windows 3.1 like file manager using the wine winefile command.

  • Run wine using the wine filespec/appname.exe command.

    The first command you will run will be to install a package. Typically something like wine /media/cdrom/setup.exe or the equivalent.