Manual Installation

In the manual installation process, you download the full archive of Piwigo, extract its content and transfer it on your web server.

The NetInstall simplifies the download/extract/transfer steps, as you have a single file to take care of.

Step 1 - Download The Full Archive

Download the full archive and unzip it.

Step 2 - Transfer Archive Content

Transfer the archive content to your web server with any FTP client.

Piwigo team recommends FileZilla as a FTP client software, because it is free as Piwigo is, and compatible with both Windows and Linux.

Start FileZilla and fill the following connection settings with the information given by your web hosting provider:

  • Host
  • Username
  • Password

Click on the Quickconnect button. You are now connected to your web server.

  1. Create a directory “photos” on your web server.
  2. On you hard disk drive, open the “piwigo” extracted directory.
  3. Select all the files and transfer them on your server in the “photos” directory, [fig A].

[A] Connect and transfer

You can also install Piwigo at the website root, the “photos” directory is not mandatory. Whatever directory name you choose, it is recommended to avoid showing Piwigo release number.

Step 3 - Configuration

Once all files are transfered, go to the web address with a web browser, for example http://example.com/photos Piwigo will detect nothing is installed yet, and redirect you to the installation page.

Now comes the MySQL database settings and the webmaster account to administer your gallery [fig B].

[B] Installation page

Fill in MySQL database connection settings, as given by your web hosting provider:

  • Host
  • User 1)
  • Password
  • Database name
  • A prefix for Piwigo table names 2)

The webmaster account creation requires:

  • An account identifier, chosen by you
  • A password you have to enter twice, for checking
  • Your email address, so that visitors can contact you

Run the “Start Install” action.

Step 4 - First connection

You will be informed [fig C] about either success or failure of the installation process.

[C] Successful installation

Once the installation is finished, you can go into your gallery [fig D]. Login with your webmaster account, and you can reach the administration panel.

[D] Piwigo is installed

1) Warning, your web hosting provider may provide separate connection settings for FTP and MySQL.
2) Most often, web hosting providers allow a single database per customer, but you can create as many tables as you want in the same database. To avoid conflicts with other web applications, or allow several Piwigo installations on the same website, the table names have a prefix. By default, this prefix is ”piwigo_”, but you can change it (only alphanumeric characters are allowed).
 
Back to top
user_documentation/learn/install/installation_manual.txt · Last modified: 2018/01/19 13:46 by plg
 
 
github twitter newsletter Donate Piwigo.org © 2002-2023 · Contact