Introduction

Piwigo is a popular open-source photo gallery software. In this article, I will show you how to install Piwigo on a AKLWEB HOST server based on the One-Click LEMP application.

Prerequisites

• Deploy a One-Click LEMP AKLWEB HOST app.
• Login to the app VPS over SSH as root (otherwise you may use sudo).

Step one: Create a database

Display the MySQL root password on your terminal.

cat /root/.my.cnf

Use the root password to log into the MySQL console.

mysql -u root -p

Create and configure a database in MySQL with the following commands. Remember to replace the database name piwigo, the user name myusername, and the password mypassword with your own ones.

create database piwigo;
create user 'myusername'@'localhost' identified by 'mypassword';
grant all privileges on piwigo.* to 'myusername'@'localhost' identified by 'mypassword' with grant option;
flush privileges;
exit;

Step two: Download the Piwigo NetInstall script

Piwigo can be installed with a single NetInstall script or a full archive package. As a matter of convenience, we will use the former.

First, you need to delete the default files that were created by AKLWEB HOST.

cd /usr/share/nginx/html/
rm -f background.jpg index.php logo.png

Visit the Piwigo offical website from your browser, click the button Download NetInstall to download the script named piwigo-netinstall.php to your local machine. Then, upload it to the directory /usr/share/nginx/html/ on your AKLWEB HOST VPS with your SCP client of choice.

Step three: Configure and install Piwigo from your browser

Before the installation, you need to add write permissions to the directory /usr/share/nginx/html/, or you will encounter a permission error.

chmod -R a+w /usr/share/nginx/html/

Visit http://[SERVER_IP]/piwigo-netinstall.php in your browser. Substitute the [SERVER_IP] with the IP address of your VPS. Follow the on-screen instructions to configure Piwigo.

On the page of “Welcome to NetInstall”, you can choose the language and install destination.

For this article, we will choose to install Piwigo in the root directory. Delete “piwigo” from the textbox. Alternatively, you could specify another destination.

Click the button “Retrieve and unzip Piwigo”.

On the page of “Congratulations!”, click “Install Piwigo now”.

On the page of “Configurations”, you need to input parameters as specified below.

Basic configuration

Pick a language as you wish.

Database configuration

Host: localhost
User: myusername
Password: mypassword
Database name: piwigo
Database table prefix: piwigo_

Remember to replace the database user myusername, the database password mypassword, the database name piwigo, and the database table prefix piwigo_ with your own ones. Do not modify the “Host” field.

Administration configuration

Specify administrator’s username, password and email address.

Click “Start installation”.

On the page of “Congratulations!”, click “Visit the gallery”.

You may see a warning message.

Warning: strftime(): It is not safe to rely on the system's timezone settings. 

To fix the warning, you need to modify the php.ini file.

vi /etc/php.ini

Locate the following line.

;date.timezone = 

Assuming that your VPS has been deployed at “Los Angeles, California”, you need to update the line as follows.

date.timezone = America/Los_Angeles

If your VPS will be deployed at another location, you can find the appropriate value from https://php.net/manual/en/timezones.php.

Save and quit vi.

:wq

To put these changes into effect, you need to restart the web server:

service nginx restart && service php-fpm restart

That’s it. You have installed Piwigo onto your AKLWEB HOST VPS. Visit http://[SERVER_IP]/ to start to use it.