How to install the script
- Unpack the archive preserving the directory structure.
You can rename the coppermine folder, but not the files or folders within.
- Upload all files onto your webserver (making sure to use the correct ftp mode)
- Set permissions on the "albums" and "include" folders in your Coppermine directory
Usually, you have to apply the CHMOD command, setting the permissions to 755 (or 777, depending on your server config). This step is very important and must not be overlooked!
- Ensure you have correct information about your database
- you need to know the database name as well as the details of a MySQL user account with which Coppermine should connect to the database. The database and the username must already exist, and the user must have access to the relevant database. Coppermine will not create the database for you, but it will create the tables in the database during installation, there is no need for you to add any tables yourself.
- Run the install script on your server
type the following URL into your web browser: http://your_server/coppermine_dir/install.php (your_server = your website, coppermine_dir = the folder in which you uploaded your Coppermine files.) Follow the online instructions on the install screen inserting the necessary information as requested.
- Confirm that you have all the correct information about the database that will be used for your Coppermine installation.
If no database exists for your website, you will need to create one, or have one created for you by your webhost. Your webhost can best provide you with instructions on how to go about doing this. For installation purposes, you will need to know the path of the database server that you will be using with Coppermine and details of the MySQL user account through which Coppermine will connect to the server. You must have the database server path (usually 'localhost'), your MySQL username, MySQL password, and MySQL database name prior to installing Coppermine. The user installing Coppermine must have all relevant access rights to this database.
If you are using a newly created database, there is no need for you to manually add any tables. Coppermine will create the necessary tables in the database during installation process.
What the installer does
After performing some basic checks, the installer creates the needed database tables for you and fills them with default values. It creates the file include/config.inc.php within the coppermine folder on your server that stores the database details you entered during install. If you should change your mysql database details later (i.e. if you change the password of your mysql user account or if you migrate your gallery to another server), you will need to edit include/config.inc.php manually to reflect the changes. The file include/config.inc.php also keeps the install script from being run twice: if the installer is run, a check is performed wether the config file exists - if yes, the installer will stop and redirect the user to the index page.
Related information
There are some additional pieces of information that are related to installing:
- Auto-Installers (like Fantastico)
Find out what is wrong with them, why you should not use them and what you can do if you have used an auto-installer
- Installation FAQ
Frequently asked questions related to installing coppermine. Read first before asking questions!
- Uninstall
Although we're convinced that Coppermine is just right for everyone, you might want to get rid of it (for whatever reasons) - here are instructions how to accomplish this.
- Getting started (first steps after install)
So you have successfully installed Coppermine? Way to go - here is another short page that should get your coppermine gallery configured and filled with content in no time.