Change the Bottle Directory in Crossover Mac

By default, Crossover Mac and Crossover Games Mac will look for bottles in the /Users/(username)/Library/Application Support/Crossover (Games)/Bottles directory. You can change where Crossover looks for this directory and have Crossover setup its bottles directory in a new location.

There are two methods. One quick way is to open Terminal and enter:
defaults write com.codeweavers.CrossOver BottleDir <path>
The <path> should be properly escaped/quoted. Dragging a folder in from the Finder is a good way to auto-type it.

To unset it, the command would be:
defaults delete com.codeweavers.CrossOver BottleDir
To affect CrossOver Games, specify com.codeweavers.CrossOverGames instead of com.codeweavers.CrossOver.

There is also a more difficult and permanent way which lets you keep multiple versions of Crossover on your machine each with their own bottle directory. To change the bottle location go to your Applications folder, right-click Crossover and choose Show Package Contents then browse to /Contents/Shared Support/Crossover/etc/CrossOver.conf

Open up CrossOver.conf with a text editor, and scroll down to [Bottle Defaults]. Under [Bottle Defaults] enter:


For example, if you wanted Crossover to create and look for bottles in a /Users/username/Bottles directory, and your username was “Bob”, you would enter:


If you wanted this rule to apply to all users on a given computer (Crossover Mac Pro, only), you would replace “Bob” with “${USER}”, like so:


To make Crossover look in more than one directory for available bottles, you can add another path after the first after a colon (:), like so:

"CX_BOTTLE_PATH"="/Users/${USER}/Bottles:/Users/${USER}/Library/Application Support/CrossOver/Bottles"

The above setting would look for bottles in both a user’s “/Bottles” directory, as well as a user’s “Library/Application Support/CrossOver/Bottles” directory.

Keep in mind that Crossover will only use the first given bottle directory path for bottle creation. As such, the above configuration would allow a user to see and access bottles in both directories, but any new bottles created would go into /Users/${USER}/Bottles.

Last modified on 2022-07-19 14:28:06 by Zeb Figura
Are you sure you want to delete this page?
Note: Any nested pages that are under this one will be moved up one level. Any attachments tied to this page will be deleted.
Move / Rename Page
Unknown Error, unable to move!
That page exists already!
One or more of the parent pages specified in new path do not exist!
/support/wiki/ /support/wiki/mac/faq/cxofficemacbottlelocation
CodeWeavers or its third-party tools process personal data (e.g. browsing data or IP addresses) and use cookies or other identifiers, which are necessary for its functioning and required to achieve the purposes illustrated in our Privacy Policy. You accept the use of cookies or other identifiers by clicking the Acknowledge button.
Please Wait...