Our Shopping List is a convenient web-based shopping list application designed to help you keep track of your shopping items. In this tutorial, you will learn how to install Our Shopping List on EndeavourOS Latest, a popular Arch-based Linux distribution.
Before proceeding, make sure you have the following:
First, we need to install some dependencies that are required for Our Shopping List to run. Open a terminal window and run the following command:
sudo pacman -S git nginx mariadb php php-fpm php-gd php-intl php-mbstring php-mysql php-pgsql
Enter your password when prompted, and wait for the installation to complete.
Next, we need to clone the Our Shopping List repository from GitHub. To do this, run the following command:
git clone https://github.com/nanawel/our-shopping-list.git
This command will download the repository to your current directory.
Now, we need to configure NGINX and PHP-FPM to work together. Open the NGINX configuration file with your favorite text editor:
sudo nano /etc/nginx/nginx.conf
In this file, find the following line:
# include /etc/nginx/conf.d/*.conf;
Uncomment it by removing the '#' at the beginning, and save and close the file.
Next, open the PHP-FPM configuration file:
sudo nano /etc/php/php-fpm.conf
Find the following line:
;include=/etc/php/fpm.d/*.conf
Uncomment it by removing the ';' at the beginning, and save and close the file.
Our Shopping List uses a MySQL database to store the shopping list items. To set up the database, first log in to the MySQL server:
sudo mysql -u root -p
Enter your MySQL root password when prompted.
In the MySQL prompt, create a new database and user for Our Shopping List:
CREATE DATABASE our_shopping_list;
CREATE USER 'shopping_user'@'localhost' IDENTIFIED BY 'password';
GRANT ALL PRIVILEGES ON our_shopping_list.* TO 'shopping_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
Replace 'password' with a secure password of your choice.
Now, we need to configure Our Shopping List to use the MySQL database. Navigate to the Our Shopping List directory:
cd our-shopping-list
Copy the sample configuration file:
cp config.sample.json config.json
Edit the config.json file with your favorite text editor:
nano config.json
In this file, set the following parameters:
Save and close the config.json file.
Finally, we can install Our Shopping List. Run the following command to install it:
sudo make install
This command will install Our Shopping List and start the NGINX and PHP-FPM services.
Open your web browser and navigate to the URL you set in the config.json file (e.g. http://localhost or http://yourdomain.com).
You should now see the Our Shopping List login page. Log in using the default credentials:
Once logged in, you can start creating shopping lists and adding items to them!
In this tutorial, you learned how to install Our Shopping List on EndeavourOS Latest, set up the proper dependencies, configure NGINX and PHP-FPM, set up the MySQL database, and finally, install and access the application. Enjoy your new shopping list and happy shopping!
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!
