How to Install Our Shopping List on EndeavourOS Latest

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.

Requirements

Before proceeding, make sure you have the following:

  • A working installation of EndeavourOS Latest
  • A web browser (such as Firefox or Google Chrome)
  • An active internet connection

Step 1: Install Dependencies

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.

Step 2: Clone the Repository

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.

Step 3: Configure NGINX & PHP-FPM

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.

Step 4: Setup the Database

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.

Step 5: Configure Our Shopping List

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:

  • "url": "http://localhost" (change the domain to your own domain name or IP address)
  • "db.host": "localhost"
  • "db.name": "our_shopping_list"
  • "db.user": "shopping_user"
  • "db.pass": "password" (replace with the password you chose in Step 4)

Save and close the config.json file.

Step 6: Install Our Shopping List

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.

Step 7: Access Our Shopping List

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:

  • Username: admin
  • Password: admin

Once logged in, you can start creating shopping lists and adding items to them!

Conclusion

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!