Launching an e-commerce store can seem complex, especially when dealing with server configurations and deployment complexities. But what if you could deploy a feature-rich, Laravel-based eCommerce platform in just a few simple steps?

In this guide, we’ll show you exactly how to install Bagisto, a leading open-source eCommerce solution, using the power and simplicity of the RunCloud server management panel.

In this tutorial, we will provide a complete, step-by-step walkthrough designed for users with limited knowledge of Linux CLI. You will learn how to set up your server environment, deploy the Bagisto application, connect your database, and perform the final installation, all with the help of RunCloud’s intuitive dashboard.

Let’s get your online store up and running!

What is Bagisto and Why Should You Use It?

Bagisto is a powerful, open-source eCommerce platform built on top of Laravel. It provides a complete solution for businesses looking to create and manage an online store.

If you’re already familiar with Laravel, then you should definitely try out Bagisto as it extends Laravel’s built-in features, elegant syntax, and extensive ecosystem. This means developers don’t have to build an eCommerce system from scratch; instead, they can use Bagisto’s pre-built modules and extend its functionality using familiar Laravel patterns, which can significantly speed up the development process.

Bagisto dashboard

Key Features of Bagisto:

  • Multi-Source Inventory: Manage your stock across multiple locations and channels from a single platform.
  • Multi-Currency and Locale: Easily configure your store to support different currencies, languages, and regional taxes to sell to a global audience.
  • Access Control Level (ACL): Implement a role-based permission system to control what your team members can access and manage within the admin panel.
  • Built-in Payment Integrations: Bagisto supports popular payment gateways, making it simple to start securely accepting payments.
  • Advanced Reporting: Gain insights into your sales, customers, and products with detailed reports and analytics.

Step-by-Step Guide for Installing Bagisto via RunCloud

RunCloud is a powerful server management panel that makes deploying and managing web applications like Bagisto incredibly straightforward. By handling the complex server configuration, it allows you to focus on building your application.

Follow the steps below to get your Bagisto store up and running with RunCloud.

Step 1: Create a New Database and Database User

First, your application needs a database to store all its information, such as products, orders, and customer details. Log in to your RunCloud dashboard and navigate to the “Databases” tab on your server.

Here, you will first create a database user by clicking “Add New Database User“.

Once you have created the user, make sure you’re in the Database tab and click “Add New Database”. Give your database a name, and from the dropdown menu, select the user you just created to grant it access.

Step 2: Create a New Web Application

Next, you need to set up the web application environment where your Bagisto files will be stored. In your RunCloud dashboard, go to the “Web Applications” section and click “Create Web Application“.

Switch to the “Empty Web App” tab and fill in the basic details for your application.

You will need to configure a few settings here to ensure Bagisto runs correctly:

  • Enter your domain name
  • Configure SSL
  • Select your application owner
  • Choose PHP version 8.2 (this is the recommended version for Bagisto at the time of writing).

Finally, under “Web Application Settings“, change the Public Path from its default to /public, which is the standard directory structure for Laravel applications.

Once you have made the necessary changes, you can deploy the application on your server.

Step 3: Connect the Database

After you create the web application, you need to connect the database you created in the first step.

Go to your new web application in the RunCloud dashboard and find the “Settings” tab on the left-hand menu.

On this page, you can select your Bagisto database and user from the dropdown menus to attach them to the application. This step ensures that when RunCloud performs a backup of your application, it will include both the files and the connected database in a single backup file.

Step 4: Connect to Your Server via SSH and Prepare the Directory

Now it’s time to connect to your server to install Bagisto itself. If you are not sure how to do this, then you can follow our previous guide, which explains how to use an SSH client like Terminal (on macOS/Linux) or PuTTY (on Windows), to log in.

Once connected, you need to navigate to your application’s root directory using the following command, replacing <root path> with the root path of your application, which is displayed in the RunCloud dashboard:

cd <root path>

When RunCloud creates a new application, it places a default public folder with an index.html file inside. Since Bagisto’s installation process will create its own public folder, you must first delete the existing one. You can do this by running the following command in your terminal:

rm -rf public

Step 5: Install Bagisto with Composer

You can now install Bagisto using Composer. Execute the following command in your application’s root directory to download and install all the necessary Bagisto files. The . at the end of the command tells Composer to install the files in the current directory:

composer create-project bagisto/bagisto .

Step 6: Initialize the Bagisto Application

After Composer has finished downloading the files, you need to run the Bagisto installation script. This script will set up your database tables, create your administrator account, and configure other essential settings for your store. To start this process, run the following command in your terminal:

php artisan bagisto:install

The installer will prompt you to enter several details:

  • Your database name
  • Username
  • Password (which you created in Step 1)
  • Your desired admin email and password

Once you have filled in all the information, the installation will complete, and you will see a message confirming its success, along with your admin login URL.

Note: If you are using a Dockerized server on RunCloud, you will need to use the host value (instead of localhost) in your database configuration. To learn more about this, refer to the documentation on Networking in a RunCloud Containerized Server.

Step 7: Log In and Start Building Your Store

Congratulations, your Bagisto store is now installed! You can now access the admin panel by navigating to your domain, followed by /admin (e.g., http://runcloud-demo.com/admin). Use the credentials you set up during the installation process to log in and begin adding products, configuring settings, and customizing your new eCommerce store.

Step 8: Optimize Your Application Type in RunCloud

To make managing your new Bagisto store even easier, there is one final step you can take within the RunCloud dashboard.

Navigate to your web application’s “Settings” page and change the “Application Type” from “General” to “Laravel.” This change unlocks a suite of powerful, Laravel-specific features in your RunCloud dashboard.

You will see new menu items that allow you to run Artisan commands, manage scheduled tasks (cron jobs), and configure message queues directly from the web interface, without ever needing to log in via SSH for these routine tasks. This feature is one of the many ways RunCloud simplifies application management and maintenance.

Step 9: Enable Backups and Harden Your Server for Production

Now that your Bagisto store is running, the final and most critical steps are to secure your application by setting up automated backups and hardening your server’s security settings.

RunCloud makes this incredibly simple; just navigate to the “Backup” section of your web application in the dashboard, choose your preferred cloud storage provider, and set a schedule.

Once configured, RunCloud will automatically back up your application files and the connected database, giving you complete peace of mind.

For securing the server, we recommend reading the following resources:

Wrapping Up

And there you have it! In just a few steps, you have successfully deployed a powerful, production-ready Bagisto eCommerce store. You can now log in, start adding your products, and customize your storefront to match your brand.

Throughout this process, you’ve seen firsthand how RunCloud streamlines what can often be a complex and time-consuming task. From creating databases and managing application settings with a few clicks to providing powerful, application-aware features, RunCloud handles the heavy lifting of server management so you can focus on what truly matters: building your online business.

While this tutorial focused on Bagisto, a Laravel-based application, RunCloud’s power and flexibility extend far beyond a single framework. Whether you’re looking to host a modern blog using Ghost, set up your own private cloud with Nextcloud, or deploy a custom application built with Next.js, our platform is designed to make it simple and efficient. We encourage you to explore our other guides to see just how versatile RunCloud is.

Ready to simplify your server management? Sign up for RunCloud today.