WINE Tutorial
WINE Tutorial
http://wiki.winehq.org/FAQ
WineHQ Menu
WineHQ AppDB Bugzilla Wine Wiki Wine Forums
FAQ
This FAQ, or Frequently Asked Questions, cov ers general topics about Wine. For questions related to Wine sof tware dev elopment, see the dev eloper FAQ. Quick links: running a program in Wine, running Wine f rom a terminal, uninstalling an application, getting a debugging log, running program as root. Contents 1. General questions 1. Who is responsible f or Wine? 2. Does Wine hurt Linux or other f ree operating sy stems? 3. Is Wine an emulator? There seems to be disagreement. 4. What is the dif f erence between Wine, CrossOv er, and Cedega? 5. Do I hav e to use the command line? 6. Will Wine work with my application? 7. What applications run well with Wine? 8. How do I run Wine? 9. How can I help contribute to the Wine project, and in what way s? 2. Installing Wine 1. Which v ersion of Wine should I use? 2. How do I install Wine? 3. Can I hav e more than one Wine v ersion on my sy stem? 4. Does Wine run on 64-bit? 5. Installing on Apple 1. How do I install Wine on my Mac? 2. Can I use Wine on an older Mac without an Intel chip? 6. How do I install Wine on my netbook (eeePC, Acer Aspire One, etc.)? 7. How do I compile Wine f rom source? 8. How do I apply a patch? 3. Installing applications 1. I hav e lots of applications already installed in Windows. How do I run them in Wine? 2. How do I run an installer using Wine? 3. How can I install applications to be shared by multiple users? 4. How can I prev ent Wine f rom changing the f ilety pe associations on my sy stem or adding unwanted menu
Wiki Links
FrontPage RecentChanges FindPage HelpContents FAQ
Page Tools
Immutable Page Show Changes Get Inf o Show Raw Text Show Print View Attach File Delete Cache
User Tools
Login
1 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
Search:
entries/desktop links when I install a Windows program? 5. I hav e an MSI f ile, how do I install/run it? 6. Can I use Wine to install driv ers f or my hardware? 7. My installer tells me I don't hav e enough f ree disk space 4. Running applications 1. How do I run an application once I'v e installed it? 2. I want to pass command line arguments to my program 3. How should I start Windows programs f rom the command line? 4. When I double-click on a .exe f ile in my f ile manager, nothing happens. 5. Uninstalling 1. How do I uninstall Windows applications? 2. How do I uninstall *all* Windows applications? 3. How do I uninstall Wine? 6. Troubleshooting 1. How can I get a debugging log? 2. How do I disable the GUI crash dialog? 3. My program f roze up, how do I close it? 4. My whole computer f reezes, reboots, or shuts of f when I run my game in Wine! 5. My application say s some DLL or f ont is missing. What do I do? 6. My application won't run, and say s it needs .NET 7. My application won't run, and say s it needs Internet Explorer 8. My application runs, but text areas act strangely (e.g. lines don't wrap, double-clicking doesn't select words) 9. My application doesn't run right, and the log say s 1. Too many open f iles, ulimit -n probably needs to be increased 2. preloader: Warning: f ailed to reserv e range 00000000-60000000 3. winev dm: unable to exec '<APP NAME>': DOS memory range unav ailable 4. Failed to use ICMP (network ping), this requires special permissions 10. Graphics 1. My application complains about being unable to change the resolution or color depth. 2. The application I am try ing to run complains that it needs 256 colors but I hav e millions of colors. 3. My X screen won't go back to its normal resolution af ter running a game f ullscreen. 4. I'm using Desktop Ef f ects with Compiz, Fusion, or XGL and get poor perf ormance/odd messages/broken applications 5. Graphics in games with good ratings in AppDB are scrambled. 6. Wine display s corrupted or missing text. 7. Wine's windows and f onts are extremely large, and the winecf g window doesn't f it on the screen. 11. Sound 1. I'm using OSS in Wine and I hav e no sound. 2. Running winecf g seems to hang or complain
2 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
about f iles when I click the audio tab 3. Audio in games sounds dif f erent f rom running in Windows 4. MP3s do not play in Windows Media Play er or applications that depend on it 12. My CD or DVD disc won't eject 13. My program f ails to do networking, but my other applications can get online 14. Why doesn't DNS resolv e in 64-bit operating sy stems? 15. I deleted my Wine menu, and now I can't get it back. 16. Some key combinations in my application do not work. 17. Where can I get f urther help? 18. I think I'v e f ound a bug. How do I report this bug to the Wine programming team? 7. Using Wine 1. How do I wipe the v irtual Windows installation? 2. Can I store the v irtual Windows installation somewhere other than ~/.wine? 3. How can I run two programs as if they were on dif f erent computers? 4. I want my Windows application to be able to launch a nativ e application to open documents 5. I want to associate a nativ e program with a f ile ty pe in Wine 6. What is this "winetricks" thing? Where do I get it? 7. How do I install Internet Explorer in Wine? 8. How do I get Wine to launch an application in a v irtual desktop? 9. How do I know what v ersion of Wine I hav e? 10. How does the Wine v ersion numbering sy stem work? 11. Should I run Wine as root? 12. I ran wine with sudo or as root. How do I f ix my permission errors? 13. Which sound driv er should I select in winecf g? 14. Why isn't PulseAudio av ailable? 15. How can I make Wine f onts anti-aliased? 16. How do I change the DPI (f ont size)? 17. How do I edit the Wine registry ? 18. How do I conf igure a proxy ? 19. How do I get a debug trace? 20. What applications/serv ices conf lict with Wine? 8. Applications 1. Does Wine support DirectX? Can I install Microsof t's DirectX under Wine? 2. How come Wine doesn't work well with copy protection? 3. I f ollowed a howto I f ound on a website, and the application still doesn't work. 4. I used a third party application (Play OnLinux, WineBottler, etc.) to install or manage applications in Wine and need help. 5. My application worked with an older v ersion of Wine, but now it's broken! 6. I really need this particular application to work. How can I go about making this happen? 7. I'm writing a Windows app. How can it detect if it's running under Wine? 9. Perf ormance
3 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
1. 2. 3. 4.
What are the sy stem requirements f or Wine? My 3D application/game is v ery slow (f ps). Is Wine slower than just using Windows? I get lots of "f ixme:" messages in the terminal and Wine runs a bit slow.
10. Risks 1. Wine is malware-compatible 2. How good is Wine at sandboxing Windows apps? 3. Nautilus can delete y our home directory when y ou empty the trash!
1. General questions
1.1. Who is responsible for Wine?
Wine is av ailable thanks to the work of many people around the world. Some companies that are or hav e been inv olv ed with Wine dev elopment are CodeWeav ers, Bordeaux, TransGaming, Corel, Macadamian and Google. See Acknowledgements and WineHistory .
4 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
code to other operating sy stems that Wine supports to run on any processor - ev en processors that Windows itself does not support. "Wine is not just an emulator" is more accurate. Thinking of Wine as just an emulator is really f orgetting about the other things it is. Wine's "emulator" is really just a binary loader that allows Windows applications to interf ace with the Wine API replacement.
5 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
menu shortcuts. This does not hold true f or Mac OS X Wine usage, which is all command line currently , unless y ou use a Third party app.
1.9. How can I help contribute to the Wine project, and in what ways?
Y ou can contribute programming or documentation skills, or monetary or equipment donations, to aid the Wine dev elopers in reaching their goals. One area where ev ery Wine user can contribute to this project is by sending high quality bug reports to our Bugzilla and helping the dev elopers with any f ollowup questions that they may hav e about y our bug. It is impossible and impractical f or a dev eloper to hav e a copy of ev ery program on the market, so we need y our help ev en af ter y our initial bug report. If a dev eloper has a good idea what might be causing the bug, he or she may ask if y ou can try a patch and see if it f ixes the problem. If the patch works and then makes its way into our main dev elopment tree, the bug report will be closed, y our help will be appreciated by ev ery one and y our problem will be f ixed. For a list of ideas of how y ou can help, please consult the helping Wine page.
2. Installing Wine
6 of 40 02/18/11 13:12
http://wiki.winehq.org/FAQ
7 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
8 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
2.6. How do I install Wine on my netbook (eeePC, Acer Aspire One, etc.)?
If y ou hav e replaced the customized distro that came preinstalled on y our netbook (Xandros, Linpus, etc.) with one of the mainstream distros that prov ide up-to-date Wine packages, y ou should be able to install Wine as normal f or that distro. If y ou are still using Xandros (eeePC), Linpus (Acer Aspire One) or any other customized distro that came preinstalled on y our netbook, y ou will hav e to ask on y our netbook's support f orum. Only other users of those distros can adv ise y ou on what, if any , binary packages will work on y our sy stem, where to f ind them, and how to install them. Y ou can also try building Wine f rom source f ollowing the instructions in the Wine User Guide, but y ou will still need to consult y our netbook's support f orum regarding satisf y ing dependencies on y our particular sy stem.
3. Installing applications
3.1. I have lots of applications already
9 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
10 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
discs without exiting the installer. First, v erif y that y our CD-ROM driv e is assigned a driv e letter in the "Driv es" tab of winecfg (e.g. D: -> /media/cdrom ). Then run the installer this way :
3.4. How can I prevent Wine from changing the filetype associations on my system or adding unwanted menu entries/desktop links when I install a Windows program?
Users who do not want the installer f or a Windows app to change f ilety pe associations, add menu items, or create desktop links, can disable winemenubuilder.exe . There are sev eral way s to do this: 1. In winecfg: bef ore running the installer, run winecfg. Go to the Libraries tab and ty pe winemenubuilder.exe into the "New ov errides" box (it is not in the dropdown list). Click add, then select it f rom the "Existing ov errides" box. Click "Edit" and select "Disable" f rom the list, then click "Apply ." 2. Registry file: If y ou need to apply the setting many times (e.g., ev ery time y ou recreate the Wine pref ix), this approach may be more conv enient. Create a text f ile named with extension .reg (e.g., disable-winemenubuilder.reg) containing the f ollowing: [HKEY_CURRENT_USER\Software\Wine\DllOverrides] "winemenubuilder.exe"="" To apply the setting, run:
11 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
regedit disable-winemenubuilder.reg 3. Environment variable: set the WINEDLLOVERRIDES env ironment v ariable when y ou run the installer, e.g., WINEDLLOVERRIDES=winemenubuilder.exe=d wine setup.exe Disabling winemenubuilder.exe will cause wine programs to print errors that they cannot f ind it (though the errors do not seem to interf ere with program operation). An alternativ e approach that av oids the errors is to replace it with the do-nothing program. Compile the f ollowing with MinGW's gcc under wine and place the executable at C:\Windows\System32\winemenubuilder.exe :
12 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
That will then run the MSI program the same as if y ou had doubleclicked it in Windows.
df -h $HOME
If the amount of space y ou need is less than 1 GB, and df reports y ou hav e more than 1 GB av ailable, try setting the Windows v ersion to Windows 98. This will work around bugs in some old (Windows 98 era) installers that could not cope with large driv es. If y ou want to use a dif f erent partition that has more f ree space, use a winepref ix that is located on the other partition. Note that y our other partition must be a Unix f ilesy stem; FAT and NTFS partitions will not work. See How can I run two programs as if they were on dif f erent computers f or instructions.
4. Running applications
4.1. How do I run an application once I've installed it?
Af ter y ou install an application with Wine, it will probably hav e an entry in the y our computer's Applications->Wine->Programs menu, and/or an icon on the desktop, just as it would under Windows. Y ou should be able to use them just as y ou would on Windows. Alternately , browse to the .wine/drive_c/Program Files f older in y our home directory (it is hidden, so y ou might need to do View->Show Hidden Files in y our f ile manager), look f or the application's main .exe f ile (y ou may hav e to guess), and double-click it. Or, if all else f ails, open a terminal window, and nav igate down to the application's directory . For example:
13 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
ereg.exe
4.3. How should I start Windows programs from the command line?
This will allow y ou to see messages f rom Wine that may help troubleshoot problems. Because Windows programs will of ten look f or f iles in the location
14 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
they were started f rom, when using the command line y ou should start them in a v ery specif ic way : "change directory " to the f older where the program is located and run the .exe f ile using only its f ilename. For example:
15 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
err:module:import_dll Library MFC42.DLL (which is needed by L"C:\\Program Files\\Yoyodyne \\Overthruster.DLL") not found
it means y ou need to install a missing runtime library ; see e.g. "My application won't run, and say s it needs MFC42.DLL" below.
5. Uninstalling
5.1. How do I uninstall Windows applications?
Y ou can run Wine's uninstaller command; this is like Windows' "Add/Remov e Programs" f unction. It should remov e menu and desktop entries... but it's not well tested; it might not work with all apps. See below f or a reliable way to remov e *all* Windows apps.
rm -rf $HOME/.wine
But that doesn't remov e them f rom the sy stem menu; to clean out the menus, caref ully paste the f ollowing commands into a terminal:
16 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
the package manager again to uninstall Wine. (If y ou installed Wine f rom source, then use make uninstall in the source directory to remov e it.) This won't uninstall y our Windows apps, though; see abov e f or that.
6. Troubleshooting
6.1. How can I get a debugging log?
Run y our application f rom the command line (see How should I start Windows programs f rom the command line?) Y ou can then copy the log f rom the screen and paste it into a f ile if it's short; otherwise redirect the output of wine to a f ile using a Unix shell redirection, e.g.
sh winetricks nocrashdialog
If y ou pref er to do it manually , copy the f ollowing key to a text editor:
regedit crashdialog.reg
(Y ou may need to specif y the f ull path to the f ile, depending on where y ou sav ed it.)
17 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
To turn the GUI crash dialog back on, change 00000000 to 00000001 and reapply . These changes can also be made by simply running regedit and adding/changing the appropriate key the point-and-click way .
killall -9 Application.exe
If y ou want to kill all Wine programs at once, y ou can run:
wineserver -k
Y ou can also open up a Wine v ersion of the Windows task manager by running wine taskmgr in a terminal. This will allow y ou to kill indiv idual Wine processes.
6.4. My whole computer freezes, reboots, or shuts off when I run my game in Wine!
If y ou are getting a complete deadlock and are unable to ev en use y our mouse af ter running Wine, it's probably not a specif ic problem with the Wine sof tware. Wine is a user-lev el process, and shouldn't be able to completely hang the operating sy stem under any circumstances. Instead, Wine is likely exposing a deeper problem with the sy stem, such as a def ectiv e hardware driv er, a bad memory stick, or ov erclocking f lakiness. It's of ten a graphics driv er problem, in which case non-Wine apps might also be af f ected. If running glxgears also crashes, it's def initely a graphics driv er problem. The most common cause is upgrading to a new kernel without also updating the graphics driv ers to match. Try reinstalling y our graphics driv ers. If the computer is a laptop and shutting itself of f entirely , a likely cause is ov erheating. Some laptops hav e problems with cooling to begin with, and the Linux ACPI code controlling f ans is known to be buggy . If that doesn't help, ask f or help on the wine-users f orum. Be sure to mention the name of the app, the v ersion of wine, the output of cat /etc/issue , lspci | grep -i vga , and, if y ou're using the proprietary NVidia driv ers, cat /proc/driver/nvidia/version . May be someone can help.
18 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
19 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
under Wine. See the Mono Project AppDB page f or more inf ormation.
6.8. My application runs, but text areas act strangely (e.g. lines don't wrap, double-clicking doesn't select words)
Y ou may hav e run into a bug in Wine's RICHED20.DLL. Y ou can try using Microsof t's RICHED20.DLL by running winetricks and selecting riched20. This may let y ou work around the problem until the Wine dev elopers f ix the bug.
20 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
Here's another method that's more portable (might ev en work on Mac OS X), but only works temporarily , and only raises the limit f or apps started f rom the current terminal window:
$ # # $
6.9.3. wine v dm: unable to e xe c '<APP NAM E>': DOS me mory range unav ailable
This issue is being f ollowed in bug 12516. The cause is a Linux kernel setting. Run cat /proc/sys /vm/mmap_min_addr"as root, if it does not equal 0 then running sysctl -w vm.mmap_min_addr=0 as root can be used to temporarily f ix the issue; to f ix it permanently , add the line vm.mmap_min_addr=0 to /etc/sysctl.conf. Please record if y ou do this alteration, as the area Wine needs may change. See PreloaderPageZeroProblem f or more inf ormation.
6.9.4. Faile d to use ICM P (ne twork ping), this re quire s spe cial pe rmissions
On *NIX sy stems ICMP ping requires use of raw sockets, which is limited to super user (root) only . And running Wine as root is a bad idea. Fortunately newer v ersions of Linux allow granular permission control to grant only required permissions to specif ied f iles. To allow Wine opening raw sockets run this command:
6.10. Graphics
6.10.1. M y application complains about
21 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
6.10.2. The application I am trying to run complains that it ne e ds 256 colors but I hav e millions of colors.
The inability to switch f rom 24bpp mode to 8bpp mode is a limitation of X, not a bug in Wine. See 256ColorMode f or some possible workarounds.
6.10.3. M y X scre e n won't go back to its normal re solution afte r running a game fullscre e n.
Y ou can of ten work around this by changing the screen resolution and then changing it back again under the sy stem pref erences. Alternately , y ou can run this terminal command to restore y our X settings:
xrandr -s 0
6.10.4. I'm using De sktop Effe cts with Compiz, Fusion, or XGL and ge t poor pe rformance /odd me ssage s/broke n applications
Using compositing managers in X11 tends to cripple OpenGL perf ormance or break OpenGL entirely (this does not apply to the Mac OS X compositor, which cannot be disabled). We recommend that y ou disable them entirely bef ore try ing to use Wine. If y ou are using one and experiencing slow perf ormance then please do not f ile bugs in Wine, as these are bugs in y our window manager or y our v ideo driv ers. Also, disabling the Composite extension within /etc/X11/xorg.conf will most certainly prev ent any compositing f rom af f ecting Wine.
22 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
hav e problems in Wine. As a rule of thumb, at least games that use shaders are broken. See this posting and Wine bug 7411 f or details. Other hardware (Intel/S3/Matrox etc.) will probably run only old (non-shader) games. Compatibility is not well tested. Same f or open source driv ers as their 3D support is ty pically basic only .
6.10.7. Wine 's windows and fonts are e xtre me ly large , and the wine cfg window doe sn't fit on the scre e n.
Sometimes y ou can use the ALT key and the mouse to mov e the winecfg window so y ou can reach the "Screen Resolution" slider on the Graphics tab; slide it down. Changes will not ef f ect the winecfg window until it's restarted. If that doesn't work, y ou can use this one line registry change (all one line):
echo -e "[HKEY_LOCAL_MACHINE\\System \\CurrentControlSet\\Hardware Profiles\\Current\\Software\\Fonts] \n\"LogPixels\"=dword:60\n" | wine regedit If all f ails, y ou could remov e y our ~/.wine directory and reinstall y our Windows applications.
23 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
6.11. Sound
6.11.1. I'm using OSS in Wine and I hav e no sound.
Unless y ou're using a sound card with an emu10k1/2 chipset (SB Liv e!/Audigy ) or another ty pe of card that supports "hardware mixing" then y ou can only ev er hav e one application using sound at the same time. If y ou hav e aRts (KDE sound sy stem), ESD (Gnome sound sy stem) or any music applications open then y ou simply won't hear any thing f rom Wine. Y ou need to kill or close all these programs bef ore being able to get sound f rom Wine. To work out if any thing has locked y our sound-card already , y ou can do cat /dev/urandom >> /dev/dsp. If y ou get an error message it means that something is using it. If y ou get loud static this means that y our sound card is clear and ready f or use.
6.11.2. Running wine cfg se e ms to hang or complain about file s whe n I click the audio tab
The hang is caused by the NAS sound driv er. This causes winecfg to pause f or a while but it should respond ev entually . The only way to get around this is to remov e NAS f rom y our sy stem and/or build Wine without NAS support in the f irst place. If y ou see messages about JACK in the terminal, they can be ignored unless y ou intend to use the JACK driv er. If y ou wish to use the JACK driv er, y ou need to install JACK's libraries onto y our machine bef ore JACK will work.
24 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
The workaround f or lack of libmpg123 and/or winemp3.acm is to use the codec installed by WMP9, l3codeca.acm. Copy l3codeca.acm to the winepref ix's /windows/sy stem32 directory (or use winetricks to install WMP9), then create a sy mlink to it named winemp3.acm in the same directory . Wine will then use the nativ e codec to play MP3s. This only af f ects WMP and apps that rely on it f or MP3 play back (including Powerpoint). Apps that install their own MP3 codec, such as Winamp or VLC Play er, should be able to play MP3s without this workaround.
wine eject d:
6.13. My program fails to do networking, but my other applications can get online
Note: These instructions are f or older Wine installs. If y ou're using Wine 1.x and y our application still f ails to do networking, y ou can giv e this a try as well. If y ou're running Wine 1.x and below instructions work f or y ou, file a bug so we can f ix Wine to improv e other people's experience. Y ou need to make sure that y our hostname resolv es to the IP address of y our network interf ace. To v erif y if y ou hav e this problem run hostname -i. If it returned IP address starting f rom "127." then read on. To set this up correctly , y ou can ty pe the f ollowing f rom a terminal:
hostname
This will return y our hostname the way y our computer sees it. Now, y ou need to open an editor with sy stem administrator priv ileges, how y ou do this will depend on the distribution y ou are using. Open the f ile /etc/hosts and see if there is an entry f or y our hostname. Assuming y our hostname is "y ourhost" and y our network IP address is 192.168.0.23, the entry might look like this:
127.0.0.1 yourhost.yourdomain.com
Change this to (or add, if there is no such line):
yourhost
25 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
192.168.0.23 yourhost.yourdomain.com
yourhost
For most Windows games with networking problems, this is all y ou need to get networking to work.
26 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
6.18. I think I've found a bug. How do I report this bug to the Wine programming team?
Bug reports should be submitted to our online Bugzilla sy stem (http://bugs.winehq.org/). To increase dev eloper productiv ity and f acilitate a resolution to submitted bugs, please read the Wiki
27 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
article on Bugs. A poor bug report may be marked INVALID and closed, leav ing y ou no closer to resolv ing y our problem. High quality bug reports are an essential part of making Wine better. Please note that y ou should generally av oid submitting bug reports if y ou hav e used any third party applications or nativ e DLL ov errides.
7. Using Wine
7.1. How do I wipe the virtual Windows installation?
Y ou can remov e y our v irtual Windows installation and start f rom scratch by either remov ing the hidden .wine directory in y our home f older. Please note that in the following commands there should be no spaces in the path, particularly between $HOME/ and .whatever.
rm -rf $HOME/.wine
or renaming it (in case y ou want to keep it f or a backup):
mv $HOME/.wine $HOME/.wine-old
This will leav e dangling MIME entries and desktop entries in ~/.local /share. To remov e these, see How do I uninstall Windows applications? Alternativ ely , y ou can stop Wine f rom creating them in the f irst place.
7.2. Can I store the virtual Windows installation somewhere other than ~/.wine?
Y es: ~/.wine is just the def ault Wine "pref ix" (a.k.a. "conf iguration directory " or "bottle"). Y ou can change which pref ix Wine uses by changing the WINEPREFIX env ironment v ariable (outside Wine). To do this, run something like the f ollowing in a terminal:
28 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
others, and each pref ix has its own wineserver instance. Wherev er y ou see "~/.wine" or "$HOME/.wine" in this Wiki, y ou can usually replace it with "$WINEPREFIX".
7.3. How can I run two programs as if they were on different computers?
Example: Y ou hav e serv er and client programs. One won't run in the presence of the other. Using dif f erent Wine pref ixes will help y ou here, since they simulate two Windows computers, in essence. Run the f irst program as normal:
wine first-program.exe
The second needs to be run in a dif f erent pref ix, so we need to change the WINEPREFIX v ariable:
7.4. I want my Windows application to be able to launch a native application to open documents
Y ou can start nativ e applications directly f rom Wine only if y ou specif y the f ull path or use the shell:
29 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
handler on y our sy stem (on a Unix desktop it uses xdg-open). Sav e the lines below to a f ile pdf.reg.
[HKEY_CLASSES_ROOT\.pdf] @="PDFfile" "Content Type"="application/pdf" [HKEY_CLASSES_ROOT\PDFfile\Shell \Open\command] @="/bin/sh run_linx_program acroread \"%1\""
Y ou can reuse this script and just edit the registry f ile. For example to associate .doc documents with OpenOf f ice (oof f ice):
[HKEY_CLASSES_ROOT\.doc] @="DOCfile" "Content Type"="application/msword" [HKEY_CLASSES_ROOT\DOCfile\Shell \Open\command] @="/bin/sh run_linx_program ooffice \"%1\""
30 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
31 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
like "wine-1.1.25"; if y ou are using Git then y ou will hav e a v ersion along the lines of "wine-1.1.25-311-g3d6bb38". TIP: Y ou can f ind out what the latest release of Wine is f rom WineHQ's main page. Currently , Wine dev elopment releases come out ev ery two weeks. Y our operating sy stem may ship with an out of date (obsolete) v ersion of Wine. Depending on what OS y ou use, y ou may be able to add an update source to y our package management sy stem to keep up to date. Check the downloads page f or details.
32 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
30 May 2008 6 Jun 2008 13 Jun 2008 17 Jun 2008 First "stable" v ersion 27 Jun 2008 First "dev elopment" v ersion 11 Jul 2008 25 Jul 2008 16 Jul 2010 Second "stable" v ersion
7.12. I ran wine with sudo or as root. How do I fix my permission errors?
Y ou need to f ix the permissions on y our ~/.wine directory , this is where all Wine state, conf iguration and any important data y ou might hav e such as installed programs, sav ed data within Wine programs, etc. are stored. Once y ou delete or f ix the permssions on this directory , rerun Wine as a regular user alway s! Run the f ollowing to f ix the permissions on y our ~/.wine directory if it now has root permissions.
cd ~
33 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
34 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
entire Windows registry , this will just break Wine. See also: Usef ulRegistry Key s
"ProxyEnable"=dword:00000001 "ProxyServer"="proxy-serveraddress:port"
At present, Wine's wininet.dll does not support proxy autoconf iguration (PAC) scripts. For winhttp, y ou'll need to use the proxycfg.exe utility to conf igure the registry . This utility is av ailable in the sy stem32 directory of a Windows installation, and MSDN describes its usage.
35 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
/etc/X11/xorg.conf will most certainly prev ent compositing f rom af f ecting Wine. Pulseaudio is also known to be buggy when emulating Alsa/OSS and conf licts with Wine. Key board switching tools such as xneur (gxneur, kxneur) and SCIM hav e been reported to conf lict with key board input in Wine.
8. Applications
8.1. Does Wine support DirectX? Can I install Microsoft's DirectX under Wine?
Wine itself prov ides a DirectX implementation that, although it has a f ew bugs lef t, should run f ine. Wine supports DirectX 9.0c at this time. Plans f or DirectX 10 are underway . If you attempt to install Microsoft's DirectX, you will run into problems. It is not recommended nor supported by Wine HQ to attempt this. Y ou can install the runtime, but it will not run. The runtime needs access to the Windows driv ers, and Wine cannot access them f or obv ious reasons. The only nativ e Microsof t DLLs that could be usef ul any way are the d3dx9_xx.dll ty pe ones, and these require y ou to accept Microsof t's license. Additionally , v ersions of these DLLs are now part of the Wine tree. So, as Wine improv es these DLLs will only become less relev ant. That said, there are some guides out there which describe how y ou can install Microsof t's DirectX. We reiterate: It is not recommended nor supported by Wine HQ to attempt this. Furthermore it is considered of f topic in Wine HQ support mediums (such as the f orums). Please use a clean Wine conf iguration f older bef ore seeking help. (Y ou may need to rm -rf ~/.wine and re-install y our Windows applications.)
8.2. How come Wine doesn't work well with copy protection?
Copy protection uses sev eral "dirty " methods to detect if discs are "real" or not. Some of these methods work in Wine but most do not, such as the extremely inv asiv e StarForce sy stem. Wine would need to be altered to allow f or almost rootkit-like f unctionality of programs to get some of these copy protection schemes to work, so support is likely to be a long time of f if ev er. (Some people use illegally modif ied or "cracked" games with the copy protection remov ed, but the Wine project cannot adv ocate that.) See also our page on copy protection.
http://wiki.winehq.org/FAQ
doesn't work.
There are many unof f icial howtos f or v arious apps posted on blogs and f orums. They are rarely maintained by their authors, and because of Wine's rapid rate of dev elopment, ev en ones that were correct at the time they were posted can quickly become outdated. Apply ing tweaks that are no longer needed in current Wine can actually prev ent an app that now runs f ine without tweaks f rom working at all (Of f ice 2007 is a prime example). The only howtos supported here are the ones on this site. If y ou insist on f ollowing an outside one, ask its author f or help. If in doubt, start again installing the app in a f resh winepref ix and ask f or help on the user f orum.
8.4. I used a third party application (PlayOnLinux, WineBottler, etc.) to install or manage applications in Wine and need help.
Consult the support channels f or whatev er third party application y ou used. Links to some of these outside applications are prov ided as a conv enience on the Third Party Applications page, but they are not supported here. Bef ore seeking help on the f orum/mailing list/IRC or f iling bugs, reinstall y our Windows application using plain Wine.
8.5. My application worked with an older version of Wine, but now it's broken!
These are called regressions. Please perf orm a regression test to identif y which patch caused the regression, then f ile a bug report and add the regression key word - we'll pay special attention to it, since they 're a lot easier to f ix when caught early .
8.6. I really need this particular application to work. How can I go about making this happen?
We're glad y ou asked. Please see our Helping Wine page f or some suggestions. Brief ly , y ou can improv e Wine y ourself , conv ince someone else to do it f or y ou, or try some complicated hacks inv olv ing nativ e Windows DLLs rather than Wine's unf inished ones.
8.7. I'm writing a Windows app. How can it detect if it's running under
37 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
Wine?
This is a bad idea. See the Dev eloper FAQ.
9. Performance
9.1. What are the system requirements for Wine?
The rule of thumb is that if y our application runs f ine in Windows, it should run f ine on the same sy stem using Wine. Wine, along with the operating sy stem y ou use to run it, generally requires less disk space and memory than Windows itself . If y ou're not currently running a Windows application, Wine won't consume any resources at all other than about 20 megaby tes of disk space.
9.4. I get lots of "fixme:" messages in the terminal and Wine runs a bit slow.
Ignore them. Generally speaking, a f ixme message will not make much sense to someone unf amiliar with Wine dev elopment. They are f or Wine dev elopers. Also, it's important to understand that f ixme messages of ten do not indicate a serious problem. Many applications will work f ine ev en though Wine prints a f ew fixme messages. That
38 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
said, they can still sometimes prov ide insight into how a particular application works (or doesn't work). If there are a v ery large number of these messages scrolling repeatedly , y ou can sometimes speed Wine up a little by turning them of f altogether. Y ou can do so by setting the WINEDEBUG env ironment v ariable to -all. For example, y our command line could look something like:
10. Risks
10.1. Wine is malware-compatible
Just because Wine runs on a non-Windows OS doesn't mean y ou're protected f rom v iruses, trojans, and other f orms of malware. There are sev eral things y ou can do to protect y ourself : 1. Nev er run executables f rom sites y ou don't trust. Inf ections hav e already happened. 2. In web browsers and mail clients, be suspicious of links to URLs y ou don't understand and trust. 3. Nev er run any GUI application (including Wine applications) as root. (See abov e. ) 4. Use a v irus scanner, e.g. ClamAV is a f ree v irus scanner y ou might consider using if y ou are worried about an inf ection; see also Ubuntu's notes on how to use ClamAV. No v irus scanner is 100% ef f ectiv e, though. 5. Consider remov ing the def ault Wine Z: driv e, which maps to the unix root directory . This is only a weak def ense, but it might help against some attacks. The downside to this is y ou won't be able to run Windows applications that aren't reachable from a Wine drive (like C: or D:). This includes inability to install Wine-gecko (see bug 19873). A work around is to copy /mov e/sy mlink downloaded installers to ~/.wine/drive_c bef ore y ou can run them. 6. If y ou're running applications that y ou suspect to be inf ected, run them as their own Linux user or in a v irtual machine. (The ZeroWine malware analy zer works this way .)
39 of 40
02/18/11 13:12
http://wiki.winehq.org/FAQ
10.3. Nautilus can delete your home directory when you empty the trash!
In some v ersions of Gnome (2.21.90?), if y ou mov e ~/.wine to trash, and empty the trash, ev ery thing that y ou can write to in y our root f ilesy stem is then deleted (including the contents of y our home f older). This is said to be f ixed in Gnome 2.21.92. See https://bugs.launchpad.net/ubuntu/+source/nautilus/+bug/188361 and https://bugs.launchpad.net/ubuntu/+source/gnome-applets /+bug/195207 If y ou are logged in as root, this bug is worse, it can delete y our entire hard driv e.
40 of 40
02/18/11 13:12