Our Shopping List is an open-source web application designed for managing a shared shopping list. It includes authentication functionality, enabling users to sign up, log in, and manage their own shopping lists.
The following tutorial will guide you through the installation process on Arch Linux.
Before you start, ensure that you have the following:
Begin by cloning the Our Shopping List repository from GitHub. You can do this using the following command:
git clone https://github.com/nanawel/our-shopping-list.git
This will clone the repository into a local directory called our-shopping-list
.
Next, navigate to the cloned repository and install the project dependencies using npm:
cd our-shopping-list
npm install
This will install all the required packages and dependencies for the project.
Our Shopping List stores data in a MongoDB database. You'll need to create a new database and user for the application to use.
To get started, open up a mongo shell and create a new database:
mongo
use our-shopping-list
Next, create a new user with read and write permissions on the our-shopping-list
database:
db.createUser(
{
user: "yourusername",
pwd: "yourpassword",
roles: [ "readWrite", "dbAdmin" ]
}
)
Be sure to replace "yourusername" and "yourpassword" with your desired values.
Finally, create a new file called .env
in the root directory of the project, and set the following environment variables:
MONGO_URI=mongodb://yourusername:yourpassword@localhost:27017/our-shopping-list
SESSION_SECRET=your_session_secret
Replace the values for yourusername
, yourpassword
, and your_session_secret
with your desired values.
Once you've installed the dependencies and configured the database, you can run the application using the following command:
npm start
This will start the application on port 3000. You can access it in your web browser by visiting http://localhost:3000
.
That's it! You've successfully installed Our Shopping List on Arch Linux. You can now sign up, log in, and start using the application to manage your shopping lists.
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!