Bagisto is a powerful eCommerce ecosystem that enables businesses to build and scale their online stores. As a free and open-source framework built on top of the Laravel stack, Bagisto offers a wide range of functionalities and provides complete control over your store. In this article, we will guide you through the step-by-step process of installing Bagisto on Ubuntu 23.10, ensuring a seamless setup for your online business.

Pre-requisites

Before we begin, make sure you have the following pre-requisites in place:

1. A system with Ubuntu 23.10 installed and running.
2. Root access to the system.

Step 1: Update Package Repository

First, log in to your Ubuntu 23.10 server and update the package repository information by running the following commands:

apt update
apt upgrade

Step 2: Install Apache Web Server

To install and configure Apache web server, execute the following commands:

apt update
apt install apache2
systemctl start apache2
systemctl enable apache2

Step 3: Install PHP 8.2

Next, install PHP 8.2 along with the necessary modules by running the following command:

apt-get install -y php8.2 php8.2-{common,gmp,curl,soap,bcmath,intl,mbstring,xmlrpc,mysql,gd,xml,cli,zip} libapache2-mod-php8.2

To enable the Apache php8.2 module, use the following command, and restart the Apache Web server:

a2enmod php8.2
systemctl restart apache2

Step 4: Install Node.js

To install Node.js, we’ll use nvm (Node Version Manager). Execute the following command in your terminal:

wget -qO https://raw.githubusercontent.com/creationix/nvm/v0.39.3/install.sh | bash

Update your shell ~/.profile by running the following command:

source ~/.profile

Next, list all available Node.js versions by executing the command:

nvm ls-remote

Choose the desired Node.js version and install it using the following command, replacing “v21.0.0” with the version number you want:

nvm instal l21.0.0

To verify the installation, run the command:

node -v

Step 5: Install Composer

To install Composer, use the following command:

apt install composer

To confirm the installation and check the version, run the command:

composer -V

Note: It is important not to run Composer as the root user. For more details, refer to the official documentationhere.

Step 6: Create SSH User

To add a new user for running the Bagisto application, execute the following command:

adduser bagisto

You will be prompted to set a new password for the user. Enter a strong password, your complete name, and any other necessary details. Confirm the information by selecting “Y” for verification.

Next, add the newly created user “bagisto” to the “sudo” group using the “usermod” command:

usermod -aG sudo bagisto

Now, switch to the “bagisto” user for the remaining steps:

su - bagisto

Step 7: Download Bagisto

To download Bagisto, use the following command:

composer create-project bagisto/bagisto
cd bagisto/public

Step 8: Configure Apache

Now, let’s configure Apache web server to work with Bagisto. Open the 000-default.conf configuration file using the following command:

sudo nano /etc/apache2/sites-enabled/000-default.conf

In the file, locate the line DocumentRoot /var/www/html and change it to:

DocumentRoot /home/bagisto/bagisto/public/

Next, open the envvars file for configuration:

sudo nano /etc/apache2/envvars

Make the following changes to the file:

exportAPACHE_RUN_USER=bagisto
exportAPACHE_RUN_GROUP=bagisto

Now, open the apache2.conf file:

sudo nano /etc/apache2/apache2.conf

Replace the existing code with the following:

<Directory /home/bagisto/bagisto/public/>
Options FollowSymLinks
AllowOverride All
Require all granted
</Directory>

Save the changes and exit the file.

Step 9: Create MySQL Database

Switch back to the root user:

su root

If MySQL server is not installed on your server, install it using the following command:

apt-get install mysql-server

Access the MySQL server using the following command:

mysql -u root

Create a new database for Bagisto:

CREATE DATABASE bagisto;

Create a database user with a secure password:

CREATE USER 'bagistouser'@'localhost' IDENTIFIED BY 'YOUR-PASSWORD-HERE';

Replace “YOUR-PASSWORD-HERE” with a strong password of your choice.

Assign the necessary permissions to the database user:

GRANT ALL ON bagisto.* TO 'bagistouser'@'localhost' WITH GRANT OPTION;
FLUSH PRIVILEGES;
EXIT;

Step 10: Configure PHP

Edit the php.ini file using the following command:

nano /etc/php/8.2/apache2/php.ini

Make the following changes to the file:

file_uploads = On
allow_url_fopen = On
short_open_tag = On
memory_limit = 256M
upload_max_filesize = 100M
max_execution_time = 360
date.timezone = America/Chicago

Save the changes and exit the file.

Step 11: Configure Bagisto

Switch back to the Bagisto directory:

cd /home/bagisto/bagisto

Open the .env file and update the MySQL database details:

nano .env

Make the following changes in the file:

DB_CONNECTION=mysql
DB_HOST=127.0.0.1
DB_PORT=3306
DB_DATABASE=bagisto
DB_USERNAME=bagistouser
DB_PASSWORD=YOUR-PASSWORD-HERE
DB_PREFIX=

Replace “YOUR-PASSWORD-HERE” with the password you set for the database user.

Step 12: Install Bagisto

To install Bagisto, run the following command:

php artisan bagisto:install

Once the installation is complete, you will receive a message with the login details for the Bagisto admin panel.

Step 13: Set File Permissions

To ensure proper file permissions, execute the following commands:

chmod -R 755 /home/bagisto/bagisto
chown -R bagisto:bagisto /home/bagisto/bagisto
systemctl restart apache2

Step 14: Install SSL Certificate

To secure your Bagisto installation with an SSL certificate, install certbot via snapd using the following commands:

apt install snapd
snap install core; sudo snap refresh core
snap install --classic certbot
ln -s /snap/bin/certbot /usr/bin/certbot

Since we’re using Apache web server, run the following command to obtain and install the certificate:

certbot --apache

Certbot will automatically handle the renewal of your certificate before it expires. You will only need to run the certbot command again if you make changes to your configuration.

You can perform a test run of the renewal process with the following command:

certbot renew --dry-run

Once the certificate is installed, your Bagisto site will be accessible via HTTPS.

Step 15: Accessing Bagisto

You can now access your Bagisto admin panel by visiting the following URL:

https://bagisto.domainhere.info/admin

Replace “bagisto.domainhere.info” with the actual IP or domain configured on your server. Use the login credentials provided during the installation process to authenticate.

To view and manage your Bagisto store, visit the following URL:

https://bagisto.domainhere.info/

Remember to replace “bagisto.domainhere.info” with your own IP or domain.

Congratulations! You have successfully installed Bagisto on your Ubuntu 23.10 server. Start exploring the wide range of features and functionalities that Bagisto offers to build and scale your online business.

For reliable and scalable cloud hosting solutions, check out Shape.host’s Cloud VPS services. Shape.host provides efficient and secure hosting solutions tailored to meet the needs of businesses in the digital age.

Happy selling with Bagisto and Shape.host!