Coppermine Photo Gallery v1.6.x: Documentation and Manual

What is required

Server-sided minimum requirements

There are certain minimum requirements that need to be met in order to be able to install Coppermine:

• A web server

  Coppermine can run on any webserver - there are reports about successfull installs on Apache, Microsoft Internet Information Server (IIS), Roxen WebServer, Abyss, JanaServer. The Coppermine dev team recommends Apache.

• PHP support

  The webserver must come with support for PHP (version 5.0.0 or better), either compiled with the support for the GD library or permission to use the exec() function for the ImageMagick "convert" utility in order to make thumbnails and reduced size images. Mysql support needs to be compiled into PHP as well.

• A MySQL database

  You will need MySQL version 3.23.23 or better. MySQL 4.1 is recommended, MySQL 5 is supported. The MySQL user needs the following permissions on the database: SELECT, INSERT, UPDATE, DELETE, CREATE, DROP, INDEX, ALTER . Most users have these permissions when webhosted. If you don't have them, you will not be able to use this or any other pre-made scripts at all. If you are uncertain about your permissions, please check with your webhost. Most hosting services can probably tell you whether coppermine can or cannot be run on their servers.
  A database needs to be set up that Coppermine can use - the install script will not create a database for you, but it will automatically create the tables and data structure in your database during install. In most webhosted environments, you will already have at least one database set up for you by your webhost. If not, you will need to create one. If you do need to create a database, check with your webhost on the proper procedures for doing so. Write down your database name, userID and password. You will require all three to successfully install Coppermine.

• An image library

  Coppermine relies on the presence of an image library to create resized copies of the images that you upload. Currently, Coppermine can use either GD version 2.x (PHP has to be compiled to support it) or ImageMagick.
  (see What's ImageMagick and What is GD)

It's always a good idea to contact your webhosting service first and ask them if they are aware of any known issues when installing Coppermine.

Self-Hosting & Webserver Setup

Although Coppermine can be run on any webserver that has the minimum requirements mentioned above, the Coppermine dev team can not support you on setting up your webserver in the first place. As suggested, those are requirements, i.e. they have to be met before actually considering to run Coppermine. Please note that the Coppermine group does not recommend self-hosting unless you're an experienced webserver administrator and know your way around.

In fact, some of the Coppermine developers are webserver admins by profession, so we can judge this pretty good. We are convinced that running a webserver that is publicly accessible on the internet is a 24/7 task that should only performed by pros who have the needed skills, manpower and budget to do so. It is OK to run a locally available webserver as a testbed, but we can not recommend self-hosting, especially with unsecure setups like webservers on desktop operating systems.

When asking for support on the coppermine support board on issues related to webserver setup, you will usually get the stereotype answer that webserver setup is beyond the scope of the coppermine support board; we can not teach you webserver setup and administration because of the complexity. There is no such thing as the one server setup that will work for anybody.

Personal requirements

Coppermine is aimed at webmasters who have at least basic HTML know-how and some experience in setting up pre-made scripts. The Coppermine dev team is aware that there are Coppermine users who set up their gallery using auto-installers who have little or no experience in setting up similar scripts, which is fine as well. We just ask you to read the documentation thoroughly before asking questions on the Coppermine support board, as this should answer most newbie questions. You can use coppermine just fine using the pre-made themes that come with the coppermine package. However, if you want to modify existing themes or come up with a theme of your own (that matches the look of the rest of your site), you should have basic to intermediate HTML and CSS skills. You don't necessarilly need PHP coding skills to run or maintain a Coppermine-driven gallery.

Requirements FAQ

Some questions that are related to the minimum requirements are being covered on the install FAQ pages:

• What's ImageMagick and how can I get it?
• What's GD and how can I get it?
• How do I find out which version of PHP I have?
• How do I enable gd on my Windows server?
• How do I enable ImageMagick on my Windows server?
• How can I install ImageMagick or GD?