Vendure is an open-source eCommerce software that allows users to build and manage online stores. In this tutorial, we will be discussing the installation process of Vendure on Debian Latest operating system. Here are the steps to follow:
Before we proceed with the installation, it is important to ensure that your system is updated. Start by running the following command:
sudo apt update && sudo apt upgrade
Enter your password when prompted and wait for the installation to complete.
Vendure requires Node.js and NPM installed on your system. To install Node.js and NPM, run the following command:
sudo apt install nodejs npm
Once the installation is completed, check the version of Node.js and NPM using the following commands:
node -v
npm -v
The output should show the version numbers of both Node.js and NPM.
Vendure also requires a database server to store data. In this tutorial, we will be installing MySQL server. To install MySQL server, run the following command:
sudo apt install mysql-server
Once the installation is completed, start the MySQL service and enable it to start at boot time using the following commands:
sudo systemctl start mysql
sudo systemctl enable mysql
Create a new database for Vendure using the following commands:
mysql -u root -p
Enter your MySQL root password when prompted and run the following command to create a new database:
CREATE DATABASE your_database_name;
Exit MySQL shell by running the following command:
EXIT;
Now, we can proceed with installing the Vendure eCommerce software using the following command:
sudo npm install -g vendure
To configure Vendure, we need to create a configuration file. Create a new directory for the configuration file, change to the new directory, and create a vendure-config.json
file using the following commands:
mkdir vendure-config
cd vendure-config
nano vendure-config.json
Add the following code to the vendure-config.json
file:
{
"dbConnectionOptions": {
"type": "mysql",
"host": "localhost",
"port": 3306,
"username": "your_mysql_username",
"password": "your_mysql_password",
"database": "your_database_name",
"synchronize": true
},
"adminApiOptions": {
"authOptions": {
"secretKey": "your_secret_key",
"algorithm": "HS256"
}
}
}
Replace the following in the above code:
your_mysql_username
with your MySQL database usernameyour_mysql_password
with your MySQL database user passwordyour_database_name
with the name of the database you created in Step 4your_secret_key
with any secret key of your choiceSave and exit the configuration file by pressing CTRL+X
then Y
and ENTER
.
Run the following command to initialize Vendure:
vendure init
Follow the prompts to set up your initial admin account and the storefront settings.
Now, start the Vendure server using the following command:
vendure start
This command will start the server on port 3000 by default. You can access the Vendure storefront by visiting http://localhost:3000
in your web browser.
Congrats! You have successfully installed the Vendure eCommerce software on Debian Latest operating system. You can now start building your online store!
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!