PartKeepr is an open-source inventory management system that allows users to manage their electronic components and parts easily. In this tutorial, we will guide you on how to install PartKeepr on Linux Mint.
Before starting, make sure that your Linux Mint operating system is up-to-date.
Firstly, you need to install some of the required dependencies for PartKeepr. To do so, you can use the following command in the terminal:
sudo apt-get update
sudo apt-get install git apache2 php php-cli php-mbstring php-gd php-json php-curl libapache2-mod-php mariadb-server mariadb-client
Secondly, you need to clone the PartKeepr repository into your machine. You can do this by running the following command in the terminal:
git clone https://github.com/partkeepr/PartKeepr.git /var/www/PartKeepr
Thirdly, you need to set up the correct permissions for the PartKeepr directory. You can do this by running the following command in the terminal:
sudo chown -R www-data:www-data /var/www/PartKeepr/
sudo chmod -R 755 /var/www/PartKeepr/
Fourthly, you need to set up a database for PartKeepr to use. You can do this by running the following command in the terminal:
sudo mysql_secure_installation
This command will prompt you to set a root password, remove anonymous users, and so on. Please follow the prompts accordingly.
Next, you need to create a new database and user for PartKeepr to use. You can do this by running the following commands in the terminal:
sudo mysql -uroot -p
MariaDB [(none)]> CREATE DATABASE partkeepr;
MariaDB [(none)]> GRANT ALL PRIVILEGES ON partkeepr.* TO 'partkeepr'@'localhost' IDENTIFIED BY 'password';
MariaDB [(none)]> FLUSH PRIVILEGES;
MariaDB [(none)]> EXIT;
Note that you should replace "password" with your desired password. Make sure to remember this password as you will need it later on during the setup.
Fifthly, you need to set up Apache for PartKeepr. You can do this by running the following command in the terminal:
sudo nano /etc/apache2/sites-available/partkeepr.conf
Then, add the following lines to the file:
<VirtualHost *:80>
ServerAdmin admin@example.com
DocumentRoot /var/www/PartKeepr/web
ServerName localhost
<Directory /var/www/PartKeepr/web>
DirectoryIndex index.php
Options -Indexes +FollowSymLinks +MultiViews
AllowOverride All
Require all granted
</Directory>
ErrorLog ${APACHE_LOG_DIR}/partkeepr_error.log
CustomLog ${APACHE_LOG_DIR}/partkeepr_access.log combined
</VirtualHost>
Save and close the file.
Then, you need to enable the PartKeepr website by running the following command:
sudo a2ensite partkeepr.conf
Finally, you need to restart the Apache server by running the following command:
sudo systemctl restart apache2
Lastly, you need to run the PartKeepr setup to complete the installation. You can do this by opening up a web browser and navigating to http://localhost. You should see the PartKeepr setup page.
Follow the prompts to set up your administrator account, configure the database, and so on. When prompted for the database credentials, enter the following:
Once the setup is completed, PartKeepr should be up and running!
In conclusion, PartKeepr is an extremely useful tool that can help you manage your electronic components and parts with ease. By following this tutorial, you should now be able to install PartKeepr on your Linux Mint machine and start using it to manage your inventory.
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!
