How to Install PartKeepr on MXLinux Latest

Introduction

This tutorial will guide you through the steps to install PartKeepr on MXLinux Latest. PartKeepr is an open-source inventory management tool that allows you to manage electronic components and other parts. Follow the steps mentioned below to install PartKeepr on MXLinux Latest.

Prerequisites

Make sure to have the following before installing PartKeepr on MXLinux Latest:

  1. MXLinux Latest installed on your computer
  2. sudo access or you need to be logged in as a root user

Installing Required Packages

  1. Launch the terminal by pressing Ctrl+Alt+T.
  2. Run the following command to update the cache and upgrade the system packages:
    sudo apt update && sudo apt upgrade -y
    
  3. Install required packages using the following command:
    sudo apt install -y software-properties-common apt-transport-https
    

Adding PHP Repository

PartKeepr requires PHP 7.4, which is not available in the default MXLinux repository. We will add the ondrej/php repository to get the required PHP version.

  1. Add the ondrej/php repository by running the following command:
     sudo add-apt-repository ppa:ondrej/php
    
  2. Update the cache by running the following command:
    sudo apt update
    

Installing Required PHP Modules

PartKeepr requires some PHP modules to be installed, let's install them.

  1. Install the required PHP modules using the following command:
     sudo apt install -y php7.4-gd php7.4-json php7.4-mbstring php7.4-mysql php7.4-xml php7.4-zip
    

Installing PartKeepr

  1. Download the PartKeepr package from the official website using the following command:
     wget https://github.com/partkeepr/PartKeepr/releases/download/1.4.0/partkeepr-1.4.0.zip
    

    Note: You can also download the latest version from the official website if available.

  2. Extract the downloaded package to the Apache webserver root directory by running the following command:
     sudo unzip partkeepr-1.4.0.zip -d /var/www/html/
    

    Note: If you are using another webserver, provide the respective root directory path.

  3. Give the appropriate permissions to the extracted directory:
     sudo chown -R www-data:www-data /var/www/html/partkeepr/
     sudo chmod -R 775 /var/www/html/partkeepr/
    

Configuring PartKeepr

  1. Copy the default configuration file:
     sudo cp /var/www/html/partkeepr/config/parameters.yml.dist /var/www/html/partkeepr/config/parameters.yml
    
  2. Edit the configuration file to update the database details:
     sudo nano /var/www/html/partkeepr/config/parameters.yml
    
    Update the following lines with your database details:
     database_host: 127.0.0.1
     database_port: null
     database_name: partkeepr
     database_user: YOUR_DB_USERNAME
     database_password: 'YOUR_DB_PASSWORD'
    
  3. Save and close the file (Ctrl+X, Y, Enter).
  4. Create a database for PartKeepr using the following command:
     sudo mysql -u root -p -e "create database partkeepr;"
    
  5. Import the sample database schema using the following command:
     sudo mysql -u root -p partkeepr < /var/www/html/partkeepr/sql/partkeepr_schema.sql
    

Testing

  1. Restart the Apache webserver using the following command:
     sudo systemctl restart apache2
    
  2. Open a web browser and enter http://localhost/partkeepr in the address bar.
  3. You will be prompted with the installation page. Follow the on-screen instructions to complete the installation.

Conclusion

In this tutorial, you have successfully installed PartKeepr on MXLinux Latest. You can use PartKeepr for managing electronic components and other parts.

If you want to self-host in an easy, hands free way, need an external IP address, or simply want your data in your own hands, give IPv6.rs a try!

Alternatively, for the best virtual desktop, try Shells!