Windows 98, Windows NT, Windows 2000, or Windows XP (Apache and ```MySQL``` run as services on all of the above operating systems except Windows 98. On Windows 98, you will have to manually start Apache in a console window.)

There are a few things to be aware of:

• There are usually two or more versions of Koha available for download. Some versions are stable release versions intended for actual production use. Others are release candidates (beta test versions) intended for testing new features and helping the developers with debugging. Take time to review the release notes and choose the version you want to test.
• Evaluate Koha on a test machine, not on a production server. Even if you choose a stable version of Koha, the Windows install package referenced on these pages is still under development and should be considered a beta version. It may cause other Apache or ```MySQL``` applications to stop functioning.
• It is important at least for now that you install each of the following applications to the specified path if you want to be sure Koha will work without doing a lot of extra manual configuration. In the future, we'll try to make the Koha on Windows install more flexible to work with Apache, ```MySQL``` and Perl at alternate locations. But for now, it may only work as specified.

* The Z39.50 client for downloading bibliographic records does not work on Windows. This is due to a required underlying Perl Event module that hasn't been successfully ported to Windows yet. There may be a work-around, but it hasn't been tested. See the 'Want to Help?' section on the KohaOnWindows page, if you would like to be the one to test it.

See KohaWinDownloads page for download links for all necessary programs.

You can probably skip this step if installing to Windows 2000 or XP. If you're installing to Windows 98 or NT and haven't already downloaded and installed MS Windows Installer 2.0 at some time in the past, do it now. Apache Webserver and Active State Perl are distributed using MS Windows Installer 2.0 and won't install if Windows Installer is missing. If you are not sure, just try doing Step 2. If it doesn't work, you need Step 1.

If you are installing on Windows 95, Windows XP, or if you use Zone Alarm (or other firewall), you should visit http://www.apache.org/dist/httpd/binaries/win32/ and read the appropriate warning notes before installing Apache.

Run the install, and follow the prompts. When you reach the dialog asking for:

Network Domain (e.g. somenet.com)
Server Name (e.g. www.somenet.com)
Administrator?s email address 

enter your domain if you know it. If not part of a domain, you can enter 'mydomain' or some other text - it should not make a difference if you are running Koha on a stand-alone computer. For the Server name, enter the fully qualified domain name of your computer if it is part of a domain. Otherwise, enter your computer name without the www. and .com. If you're not sure, make something up and the Koha install should correct it for you. For the Administrator's email address, enter an email address. (I don't think the email address is used by Koha). On the same dialog you?ll also have a choice of 'for All users on port 80 …' or 'only for the Current User, on Port 8080'. In all my testing, I chose the former, which is the default. On the following dialog, choose Typical Installation and the default install folder of C:\Program Files\Apache Group\. Let the install complete and reboot if asked to do so. Do not install V2.0.44 on Windows 98 - it has a bug.

Unzip the file you downloaded and run SETUP.EXE. Install to the default location of C:\mysql. Choose a Typical Install. Let the install complete and reboot if asked to do so.

Run the file you downloaded. 'BE VERY CAREFUL TO CHANGE INSTALL PATH ON THE SECOND OR THIRD DIALOG TO C:\usr\. If you don't change it, it will default to the drive with most space and <drive letter>:\Perl\ and Koha will not work.' Accept the default settings on the rest of the install dialogs. It is not necessary to install any additional Perl modules. The Koha Windows install includes the necessary Perl modules and will do that for you.

If you have previously installed Koha using an install package provided here, consider uninstalling the old version (especially if it was a test version) before installing a newer version. First, stop the ```MySQL``` server and make a backup of any data you want to keep. Then go to Control Panel → Add\Remove Programs, and uninstall the previous version. (Note - it is possible to install more than one version at a time and switch between them - see KohaWinConfiguration page for details).

Run the Koha Windows install. It will first check to be sure Apache, ```MySQL```, and Perl are installed to the proper locations. If you get an error message about any of the required programs, it would be best to cancel the Windows Koha install and correct the problem before continuing. After a couple information dialogs, you'll be asked if you want to do a Full or Custom Install. You should choose to do a Full Install unless you are an experienced user and plan to manually configure all the programs to work together. On the Backup Replaced Files dialog, make a note of where backup files will be stored in case you need to access them. Continue and allow the install to complete.

Run Index Data YAZ install. Available from http://www.indexdata.dk/yaz/. Take note of the location where you install. Right click My Computer → Properties → Advanced Tab → Environment Variables → in the lower System Variables window click on Path and then the edit button. Cursor all the way to the end of the existing path, add a semicolon and the the path to the Yaz bin folder Modify the PATH environment variable and add the location of the program i.e. ”;C:\Program Files\YAZ\bin”. Restart your machine. This procedure is necessary to enable the Z39.50 search feature of Koha

Verify that both the Apache Webserver and the ```MySQL``` database are running: On Windows 98 - On Windows 98, be sure to reboot your computer when the installs are finished. After reboot, the MYSQL database should start automatically and you should see a Traffic Light icon in your System Tray that can be used to control the MYSQL database. If the traffic light is green, the database is running. Click the Traffic Light to access ```WinMySqlAdmin``` and you'll be given options to Shutdown or Start the ```MySQL``` database server. On Windows 98, you need to manually start the Apache Web Server each time you want to run Koha. Do this by going to Start → Programs → Apache HTTP Server → Control Apache Server and choose Start Apache in Console to start the server. You should get a DOS console window that needs to stay open but can be minimized. If the console window disappears after a brief moment, there is some problem with your Apache configuration.

On Windows NT, 2000 or XP - If you chose to do a full install of Koha, you should have two icons in your System Tray - one a Feather and the other a Traffic Light. You can access the Apache Service Monitor by right clicking on the feather. You can use the Apache Monitor to start, stop, or restart the Apache server. You can use ```WinMySqlAdmin``` to control the ```MySQL``` database by clicking on the Traffic Light. You'll be given options to Shutdown or Start the ```MySQL``` database server. If the Traffic Light is green and the feather has a green arrow (rather than a red dot) in the small white circle, then both MYSQL and Apache are running and you should be ready to run Koha.

Start your browser and access Koha - Once you are sure both Apache and ```MySQL``` are running, start Internet Explorer and type either opac or intranet on the address bar to access either the Opac or Intranet interface to Koha. The default login for the Intranet interface is koha \ koha. If you use a Proxy Server, you may need to check Bypass proxy server for local addresses under Tools → Internet Options → Connections to stop IE from going out to the Internet to look for Koha.

If you evaluate Koha, and decide it's not for you, or if any of these installs causes problems with your computer, you can uninstall them using normal Windows procedures. Go to Control Panel → Add/Remove Programs. Choose the programs one by one and then click on Add/Remove or Uninstall.

Back to « KohaOnWindows