How to Install Vendure on Debian Latest?

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:

Step 1: Update the System

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.

Step 2: Install Node.js and NPM

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.

Step 3: Install MySQL Server

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

Step 4: Create a database

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;

Step 5: Install Vendure

Now, we can proceed with installing the Vendure eCommerce software using the following command:

sudo npm install -g vendure

Step 6: Configure 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 username
  • your_mysql_password with your MySQL database user password
  • your_database_name with the name of the database you created in Step 4
  • your_secret_key with any secret key of your choice

Save and exit the configuration file by pressing CTRL+X then Y and ENTER.

Step 7: Initialize Vendure

Run the following command to initialize Vendure:

vendure init

Follow the prompts to set up your initial admin account and the storefront settings.

Step 8: Start Vendure

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.

Conclusion

Congrats! You have successfully installed the Vendure eCommerce software on Debian Latest operating system. You can now start building your online store!