How to Install HomeGallery on MXLinux Latest

HomeGallery is an open-source, web-based photo gallery application that you can install on your Linux system. It's a simple, easy-to-use tool that allows you to keep, organize, and share your photos with others. This tutorial will guide you through the steps of installing HomeGallery on MXLinux Latest using the command line.

Prerequisites

Before you start, ensure that your MXLinux Latest is up-to-date with the latest software updates. To run HomeGallery, you need to have the following software packages installed:

  • Apache2 or Nginx
  • PHP with extensions: GD, Exif, PDO MySQL/MariaDB
  • MySQL/MariaDB

You can install these packages on MXLinux Latest by running the following command:

sudo apt-get install apache2 nginx php-gd php-exif php-mysql mysql-server

Step 1: Download HomeGallery

First, you need to download the HomeGallery application from the official website. Navigate to https://home-gallery.org and click on the Download button.

Alternatively, you can use the following command to download the latest version of HomeGallery directly from your terminal:

wget https://github.com/brunophilipe/home-gallery/releases/latest/download/home-gallery-linux-amd64

Step 2: Install HomeGallery

After downloading the HomeGallery application, you need to install it on your system. In the same terminal, navigate to the directory where the HomeGallery file was saved, and run the following command:

sudo chmod +x home-gallery-linux-amd64
sudo mv home-gallery-linux-amd64 /usr/local/bin/home-gallery

The above command will set the permission of the HomeGallery file and move it to the /usr/local/bin/ directory, making it is available to all users of your system.

Step 3: Configure MySQL

HomeGallery uses MySQL/MariaDB to store photos' metadata. You need to create a MySQL database and a database user that HomeGallery can use to access the database.

To create a new MySQL database, run the following command:

sudo mysql -u root -p

In the MySQL prompt, enter your MySQL root password and run the following command to create a new database:

CREATE DATABASE homegallery;

Next, run the following command to create a new database user:

CREATE USER 'homegallery' IDENTIFIED BY 'password';

Replace password with a strong password.

Grant the new user full access to the newly created database by running the following command:

GRANT ALL PRIVILEGES ON homegallery.* TO 'homegallery';

Finally, run the following command to apply the changes and exit:

FLUSH PRIVILEGES;
exit;

Step 4: Configure HomeGallery

Next, you need to create the configuration file for HomeGallery. Navigate to the directory where you want to store your HomeGallery photos, and run the following command to create the configuration file:

sudo nano config.yml

Add the following lines to the config.yml file and update the values accordingly:

server:
  address: 0.0.0.0
  port: 8080
database:
  driver: mysql
  datasource: homegallery:password@tcp(localhost:3306)/homegallery
root:
  path: /path/to/your/photos
  scaninterval: 10m
security:
  basicauth:
    enabled: true
    username: admin
    password: password

In the above configuration:

  • server: specifies the IP address and port number of HomeGallery.
  • database: specifies the database details that HomeGallery will use to store metadata.
  • root: specifies the directory where you want to store your photos.
  • security: adds basic authentication for your HomeGallery. You can change the username and password details as needed.

Once you have updated the file, save and close it by pressing CTRL+X, Y then ENTER.

Step 5: Start HomeGallery

Finally, you can start the HomeGallery application using the following command:

home-gallery --config /path/to/your/config.yml

With the above command, HomeGallery will start, read and use the configuration values you specified in the config.yml file. You can check your MXLinux Latest's IP address and access HomeGallery via your web browser by using the URL: http://MXLinuxLatest-IP-address:8080.

Conclusion

That's it! You have successfully installed HomeGallery on MXLinux Latest. You can now start uploading your photos to HomeGallery and organizing them for easy access and sharing.