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

Table of Contents

Uploading by HTTP

Regular HTTP uploads use the browser's built-in capabilities to upload files to a server. The maximum file size is determined by two basic factors: the speed and amount of data the web-browser can upload before timing out, and the allowed file size determined by server settings. Note that those settings are not determined by coppermine, but the server config (php.ini). Users who are webhosted usually can't edit php.ini, so they will have to live with the settings the webserver admin has set up. Those who actually run their own server and can edit php.ini should take a look at the settings that are being explained on the upload troubleshooting page if (large) http uploads fail.

It should be obvious that the files have to be uploaded somewhere (into some folder) on your webserver - this is the albums folder within the folder you installed coppermine on your server. The HTTP uploads go into subfolders of the "userpics" folder (which resides within the "albums" folder). Obviously, the coppermine upload script needs write permissions to upload the files there. This is why you have to change permissions on the albums folder and everything within it during coppermine install - make it writable for the user the webserver runs under. This is done using the CHMOD command on Unix/Linux based servers. If you experience issues with uploading, make sure that you have set the permissions correctly.

Upload interfaces

Coppermine comes with two upload interfaces: a traditional one that is using plain HTML methods and allows uploading one file at a time and an advanced, flash-driven interface that allows several files to be uploaded from one screen.

Flash-driven multiple-files upload interface

The flash-driven interface offers more features and is easier to use, that's why it's recommended to use that interface as a default.


  1. Select an album from the album dropdown list
  2. Click the "Browse" button and navigate to the file you want to upload
  3. Select more files to upload by repeating step 3
  4. Click the "Continue" button after having all files that you want to upload (The button will appear after you have uploaded at least one file).
  5. You'll be sent to a screen where you can enter details about the uploaded files. After filling in, submit that form using the "Apply changes" button at the bottom of that form.

HTML-driven single-file upload interface

The HTML-driven single uploads form is recommended for those who don't have Flash installed (for whatever reasons) and particularly to trouble-shoot upload issues.


  1. Select an album from the album dropdown list
  2. Click the "Browse" button and navigate to the file you want to upload
  3. Enter file title, description and keywords into the corresponding fields if applicable
  4. Click the "Upload file" button to submit the form and actually upload the file.