Installing Ampache

Up to this point, you've been laying the foundation that Ampache requires. Apache is up and running, MySQL is installed and waiting for the setup, and PHP is waiting to work. Up to this point it is assumed that you have met the requirements laid out in Preparing your OS for Ampache.

Apache will currently serve all webpages inside of the 'htdocs' folder within your XAMPP installation. If you've followed these instructions, that's either C:\xampp\htdocs or C:\xampplite\htdocs

There are three types of Ampache downloads, Stable, Development, Nightly.

• Stable releases are just that, stable, they've been bug tested and all features should work as advertised.
• Development Releases are Point releases from SVN. This should be largely bug free however some features included in the Development Releases may not work as advertised, or at all.
• The nightly builds are automatically generated twice a day from SVN. Most of the time these will work however there may be bugs as they are automatically generated, and not individually tested.

If you wish to use the bleeding edge ampache code try-outs, you can use the SVN Repository.

svn checkout https://svn.ampache.org/trunk ampache

1. Navigate to your htdocs or wwwroot folder. In most linux systems this is some varient of /var/www/.
2. Create a folder inside of htdocs or wwwroot named 'ampache' and extract all of your files from the ampache tarball to your new ampache directory. You may need extra software to extract the files from the .tar.gz file. If you do not have software, 7-zip is a free piece of software that can handle that for you.

1. Visit this link: http://localhost/ampache This is what you should see:
   
   • If you see anything other than green 'OK' then there are installation issues and they all need to be resolved before you can continue.
2. Click the button in your new Ampache installation.

1. This should be your current screen
   
2. Desired Database Name - This is the internal name in MySQL that Ampache will be using. By default it is 'Ampache' but can be anything. If you wanted, you can even have multiple Ampache instances running off of the same server.
3. MySQL Hostname - This is the MySQL server address that Ampache will be storing all of its data. In most situations, this will be 'localhost'. If you are unsure of what you should be using, leave it as it is.
4. MySQL Administrative Username - Use 'root'. This is the MySQL username that will actually add the Ampache database to MySQL and create the first Ampache user.
5. MySQL Administrative Password - root's password for MySQL
6. Create Database User for New Database? - Check this if this is a new installation or if you're installing over top of a previous Ampache install.
7. Ampache Database Username - This is the MySQL login that Ampache will use to manipulate the Ampache database. It's a security issue to use 'root' to maintain Ampache like that so a new login is created to isolate the Ampache database access from any other databases that run on this server.
8. Ampache Database User Password - The password you want to assign to this first Ampache user.
9. Overwrite Existing - Checking this will overwrite an existing Ampache database. If you previously had Ampache installed, this will overwrite all settings, ratings, etc.
10. Use Existing Database - Check this if you're installing Ampache over a previous installation and want to use the settings already existing.
11. Click to continue

1. This should be your current screen
   
2. Web Path - This is the path where ampache resides on your server in relation to your root of http://localhost/
3. Desired Database Name - This needs to be the database name you created in the previous step.
4. MySQL Hostname - The MySQL Hostname you specified in the previous step
5. MySQL Username - The MySQL Username you created in the previous step (Default = Ampache)
6. MySQL Password - The MySQL Password you created for the MySQL Username in the previous step.
7. Click to continue
   • It will prompt for you to download a file: ampache.cfg.php Save this file to C:\xampp\htdocs\ampache\config
   • This is an extra level of security ensuring that you are the one that's supposed to be administering the database. This is also the reason why you have to re-enter the MySQL Hostname, Username, and Password even though you just entered them in Step 1 of the config.

YOU MUST ENSURE THIS FILE IS NAMED ampache.cfg.php AND NOTHING ELSE!!!

1. Check for Config - This should return a green 'OK' for both the 'Ampache.cfg.php Exists' and 'Ampache.cfg.php Configured?' options. If either of these show instead a red 'Error' then these issues need to be resolved before you can continue.
2. Click to continue

1. This should be your current screen
   
2. Username - This is the new username you will use to log into Ampache. It will be given administrative access to Ampache.
3. Password/Confirm Password - The password to be associated with the Username created above.
4. Click to finish