Installing Mingle
Introduction
There are three steps to installing Mingle:
- Configure a database.
- Download and Install Mingle (this topic).
- Configure Mingle
How to install Mingle for Windows
You must be logged in as a user with Admin privileges to install the Mingle service under Windows.
- Double-click the Mingle installer file and follow the prompts to install Mingle.
-
During installation, Mingle will ask you to:
- Select a directory to store data. This is where Mingle will store project data including configuration files and attachments. It's not the database location.
- Select a port from which to run Mingle. The default for this is '8080'. But you can set it to any port that is not currently being used.
-
At the end of the installation, Mingle opens the configuration wizard in your default web browser.

How to install Mingle for Mac OSX
- Double-click the downloaded file to unzip the contents.
- Drag the Mingle icon to the Applications folder.
- Double-click on the Mingle icon to open the launcher.
- From the launcher you can:
- select a directory to store data. This is where Mingle will store project data including configuration files and attachments. It's not the database location.
- select a network port from which to run Mingle. The default for this is '8080'. But you can set it to any port that is not currently being used.
- Click the Open browser button to start the configuration wizard in your default web browser.
-
Click the Open browser button to start the configuration wizard in your default web browser.

How to install Mingle for general Unix
- Move the downloaded file into the directory where you want to install Mingle.
- Untar the file using tar -xzvf mingle_unix_2_0_XXXX.tar.gz
-
Edit the mingle.properties file located in base install directory to specify the port on which the server will run, as well as the data directory.
Example configuration:
mingle.port=8080 mingle.dataDir=/var/mingleThe dataDir is where Mingle writes configuration files and attachments. This directory should not be within the Mingle installation folder. To avoid problems with future upgrades, keep this directory separate from the Mingle installation.
-
Start the Mingle server:
cd into the Mingle install directory and type:
./MingleServer startYou will need to be logged in as a user with the appropriate permissions to create the data directory in the location you specify. Otherwise when the Mingle Server starts up, it will not be able to create the data directory.
-
Open a browser to the Mingle root.
Using the example in Step 4, if you were configuring Mingle on the same machine the server was running on, this would be http://localhost:8080. Open your browser to the correct host and port for your installation.
The browser displays the configuration wizard.

How to install Mingle for Solaris
Follow the instructions for installing Mingle on general Unix, with the following exceptions:
- Use the UNIX zip installer rather than the tar.gz installer due to the fact that the default Solaris tar command is incompatible with the format with GNU tar.
- Ensure that the MingleServer script in the application directory has execute permissions.
How to install Mingle from the LiveCD
The Mingle LiveCD is a modified Ubuntu 7.10 LiveCD. If you want to install the LiveCD to a HDD, then you should ensure that you have backed up the contents of your HDD before installation. The install process will by default wipe the contents of the HDD and replace them with the installed files (you can override this during the install process). Alternately you can choose to create a separate partition and install the LiveCD into the new partition.
- Make sure there is nothing on the target HDD that you want to keep, as noted above - the install will by default wipe the contents of your HDD
- Ensure that the machine you are installing to has access to the internet, the install will attempt to download the latest Ubuntu patches to ensure any security patches are applied.
- Put the Mingle LiveCD into a bootable CD-ROM drive
- Boot from the CD and double-click on the install icon
- Follow the prompts
-
Open a browser to the Mingle root. In this case it will be http://localhost:4343
The browser displays the Current projects page.
To create and configure your first project, refer to the Quick project setup guide.