# Install on Windows

### Windows Prerequisites[¶](https://documentation.opencats.org/installation/broken-reference)

Installation instructions are given for the XAMPP default install environment only. WAMPP will also work if you prefer it. The steps will be a little different.

### Downloading software and preparing your system[¶](https://documentation.opencats.org/installation/broken-reference)

* Download - [XAMPP](https://www.apachefriends.org/xampp-files/5.6.28/xampp-win32-5.6.28-1-VC11-installer.exe)
* Install XAMPP

Note

You need to run MariaDB 10 and PHP 7.2, if there are various XAMPP options available, get the one with these package versions!!

* Download - [OpenCATS-0.9.6-FULL](https://github.com/opencats/OpenCATS/releases/download/0.9.6/opencats-0.9.6-full.zip). You can not install this yet.
* Extract the file to `C:xampp\htdocs`&#x20;

### Start Xampp[¶](https://documentation.opencats.org/installation/broken-reference)

* Click the Windows start button and type `xampp`
* Hit `enter`. This will open the XAMPP control panel.
* On the right side of Apache and MySQL, click `start` for each one.

Note

ONLY start the Apache and MySql services. You do NOT need any of the other services.

![\_images/start-services-xampp.png](https://1269012679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMP3hgt72kl23HAv7iDu%2Fuploads%2FXO4okFNCJ30Hm3VUuA76%2Fstart%20services%20xampp?alt=media)

* Stop the apache service (lower right corner, right click XAMPP, stop apache)
* Start the apache service

### OPTIONAL - Renaming your OpenCATS directory[¶](https://documentation.opencats.org/installation/broken-reference)

The current default directory name for the OpenCATS files is OpenCATS-0.9.6. This will result in the web address in your browser being [http://localhost/OpenCATS-0.9.](http://localhost/OpenCATS-0.9.4-3)6

If you want to rename the main OpenCATS directory to something else, you can do it now.

* Simply navigate to `C:\xampp\htdocs`
* Right click on the OpenCATS directory
* Click `rename`
* Rename the directory whatever you want (example: ATS)

Now, to access it, your browser address will be <http://localhost/ATS>

### Launch phpMyAdmin[¶](https://documentation.opencats.org/installation/broken-reference)

* In your browser, go to: <http://localhost/phpmyadmin/>

Note

If phpmyadmin does not load in this screen, stop and start your apache service again per the instructions above.

* On the left side, click `new` to create a new database

![\_images/phpmyadmin-main.png](https://1269012679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMP3hgt72kl23HAv7iDu%2Fuploads%2F2OK9xKJLRFKE6K7TEjiz%2Fphpmyadmin%20main?alt=media)

* In the box labelled `database name` type `opencats`.
* Hit `create`

**NOTE: The default encoding for new databases in MariaDB is latin-1 which will have problems with non-english characters. If you will encounter any non-english characters, please create your databases and select  UTF-8 encoding and collation;**\
\
**CHARACTER SET utf8** \
**COLLATION utf8\_general\_ci**;&#x20;

![\_images/phpmyadmin-newdb.png](https://1269012679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMP3hgt72kl23HAv7iDu%2Fuploads%2FwCJI0yMBEWUgJS3xUJJO%2Fphpmyadmin%20newdb?alt=media)

You should now see “opencats” listed among the databases on the left.

* Click the opencats database
* In the top row of tabs, on the right side of the screen, click `privileges`
* Click `add user account`

![\_images/phpmyadmin-newuser.png](https://1269012679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMP3hgt72kl23HAv7iDu%2Fuploads%2FzycdkZgQNvyiq2ZJxmIR%2Fphpmyadmin%20newuser?alt=media)

* User name, make sure `use text field` is selected, in the empty box next to it type `opencats`
* Host name: In the first box, select `local` from the drop-down options. The second box should say `localhost`
* Type opencats for the database password twice
* In the “database for user account section”, confirm that the third checkbox `Grant all privileges on database "opencats"` is checked.
* Scroll down to the bottom and click `go`

![\_images/phpmyadmin-newuser2.png](https://1269012679-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FFMP3hgt72kl23HAv7iDu%2Fuploads%2FkB7sbGoryyArbxWqhdV8%2Fphpmyadmin%20newuser2?alt=media)

Now go to [Run the installer](https://documentation.opencats.org/installation/run-the-installer)
