PartKeepr is an inventory management software that keeps track of electronic components and their availability. In this tutorial, we will discuss how to install PartKeepr on OpenBSD.
To install PartKeepr on OpenBSD, we need to install some required packages first. Open the terminal and type the following command to update the package list:
$ sudo pkg_add -Uuv
Next, install the required packages by running the following commands:
$ sudo pkg_add php php-mysqli php-gd php-mbstring php-dom php-curl git
To install and configure the MySQL or MariaDB database, run the following command:
$ sudo pkg_add mysql-server
After the installation, start the MySQL or MariaDB service by running the following command:
$ doas rcctl enable mysqld
$ doas rcctl start mysqld
By default, the MySQL/MariaDB service is not configured with any password, so the first thing we need to do is set one. Use the following command to set the MySQL/MariaDB root password:
$ sudo mysql_secure_installation
Create a new database for the PartKeepr:
$ mysql -u root -p
> CREATE DATABASE partkeepr;
> GRANT ALL PRIVILEGES ON partkeepr.* TO 'partkeepr'@'localhost' IDENTIFIED BY 'password';
> FLUSH PRIVILEGES;
> exit;
To install and configure Apache or NGINX web server on OpenBSD, follow this official documentation.
To install PartKeepr, first clone the repository using the following command:
$ git clone https://github.com/partkeepr/PartKeepr.git /var/www/htdocs/partkeepr
Next, navigate to the PartKeepr directory and copy the sample configuration file to the configuration file:
$ cd /var/www/htdocs/partkeepr
$ cp app/config/parameters.yml.dist app/config/parameters.yml
Edit the parameters.yml
file to reflect your MySQL/MariaDB database configuration:
parameters:
...
database_host: 127.0.0.1
database_port: 3306
database_name: partkeepr
database_user: partkeepr
database_password: password
...
Set the necessary permissions for the application:
$ chown -R www:www /var/www/htdocs/partkeepr
$ chmod -R 775 /var/www/htdocs/partkeepr
$ chmod -R g+s /var/www/htdocs/partkeepr
Initialize the PartKeepr database by running the following command:
$ sudo -u www /usr/local/bin/php app/console doctrine:schema:update --force
You can now access PartKeepr by visiting http://<your-server-IP-address>/partkeepr
in your browser.
In this tutorial, we have learned how to install PartKeepr on OpenBSD. With PartKeepr, you can manage your electronic components inventory and monitor their availability.
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!