What is OpenCart?

OpenCart is a free, open-source eCommerce platform built using PHP and MySQL. It enables users to build and manage fully functional online stores with support for multiple languages, currencies, payment gateways, shipping methods, and custom themes. OpenCart is known for its simplicity, performance, and wide range of extensions.

Running OpenCart on Debian 12 (Bookworm) provides a stable, secure, and efficient environment, ideal for developers, small business owners, and hosting providers who want full control over their eCommerce stack.

Key Features of OpenCart

Web-Based Administration

  • Clean and responsive admin panel to manage products, categories, customers, orders, and reports.
  • Multi-user and role-based access control.

Multi-Language and Multi-Currency

  • Support for global eCommerce with multiple languages and currency options.
  • Language packs and currency conversions built in.

Extension Marketplace

  • Thousands of modules and themes available via the OpenCart Marketplace.
  • Extend functionality for SEO, payments, shipping, marketing, analytics, and more.

Product and Order Management

  • Bulk product upload, discounts, coupons, stock status, and custom attributes.
  • Order history, invoice printing, and customer communication tools.

Integrated Payment and Shipping

  • Supports popular payment gateways like PayPal, Stripe, Square, Authorize.Net, etc.
  • Shipping options include flat rate, weight-based, pickup, DHL, FedEx, UPS, and more.

SEO and Marketing Tools

  • Friendly URLs, custom meta tags, and Google Sitemap support.
  • Built-in tools for discounts, gift vouchers, affiliate programs, and newsletters.

Why Use OpenCart on Debian 12?

Debian 12 offers a reliable platform for running web applications like OpenCart due to:

  • Long-term support and stable package base
  • High security standards and active maintenance
  • Compatibility with Apache, Nginx, PHP 8.2, and MariaDB/MySQL
  • Lightweight and efficient performance, suitable for VPS and dedicated servers

Debian’s minimal and predictable environment ensures greater control, better performance, and easier debugging for server administrators.

System Requirements for OpenCart on Debian 12

ComponentRequirement
Web ServerApache or Nginx
PHP VersionPHP 8.0 or 8.2 (recommended)
PHP Extensionscurl, zip, gd, mbstring, xml, intl, bz2, mysqli, openssl
DatabaseMySQL 5.7+ or MariaDB 10.4+
Disk Space300 MB (OpenCart core files), more for media
Memory1 GB minimum (2+ GB recommended)

Typical OpenCart Stack on Debian 12

  • Apache or Nginx as the web server
  • PHP 8.2 with required extensions
  • MariaDB or MySQL for database
  • Let’s Encrypt SSL via Certbot for HTTPS
  • Optional caching tools like Redis or Varnish

Use Cases

  • Online stores for small to medium businesses
  • Localized eCommerce platforms with language/currency support
  • B2C or B2B catalog-driven websites
  • Custom eCommerce solutions with specific workflows or integrations

Pros of Using OpenCart on Debian 12

  • Free and open-source with no vendor lock-in
  • Lightweight and fast, even on small VPS servers
  • Extensive ecosystem of themes, modules, and payment integrations
  • Easy to set up, configure, and maintain
  • Flexible API and MVC architecture for custom development
  • Debian’s package system ensures consistent, reliable updates

Cons

  • Manual setup required (not as beginner-friendly as hosted platforms)
  • Some advanced features need paid extensions
  • Lacks built-in drag-and-drop page builder (available via third-party modules)
  • Performance tuning required for large stores or high-traffic sites
  • Limited native support for headless or PWA features

Security Best Practices

  • Use HTTPS with Let’s Encrypt for all traffic
  • Set strict file and folder permissions (644 for files, 755 for directories)
  • Disable unused PHP functions and keep PHP up to date
  • Regularly update OpenCart and its extensions
  • Use Fail2Ban, UFW, or iptables for brute-force and firewall protection
  • Secure the admin directory with .htaccess or admin renaming

OpenCart on Debian 12 is a powerful and customizable eCommerce solution for those seeking full control over their online store. Debian’s rock-solid stability and OpenCart’s flexible architecture make them a perfect combination for businesses, developers, and hosting providers who prefer an open-source, self-hosted alternative to SaaS platforms.

Whether you’re launching a small shop or building a scalable eCommerce platform, OpenCart on Debian 12 offers the tools, performance, and control to make it possible.

Step 1: Create a Cloud VPS on Shape.Host

To start, deploy a clean Debian 12 server:

Go to https://shape.host and log in.

Click “Create”.

Choose “Instance”.

Shape.host Resources dashboard with Create > Instance highlighted.

Pick your preferred server location.

Shape.host instance form with the data center location selector highlighted.

Select Debian 12 (64-bit) as the operating system.

Choose a plan with at least 2 CPUs, 4 GB RAM, and 20 GB SSD.

Shape.host instance form with the operating system image selector highlighted.

Click “Create Instance”.

Shape.host instance form with the Create Instance button highlighted.

Find your instance IP address in the Resources section.

Shape.host Resources dashboard with the server IP address highlighted.

Step 2: Connect to Your VPS

Once your instance is created, you’ll receive the IP address, username (root), and password from Shape.Host.

On Linux or macOS:

Open a terminal and connect via SSH:

ssh root@your_server_ip

Press Enter, then type your password when prompted.

On Windows:

  1. Download and install PuTTY (a free SSH client).
  2. Open PuTTY.
  3. In the Host Name field, type: root@your_server_ip
    (or type just the IP address and it will ask for the username later).
  4. Make sure the Port is set to 22 and Connection type is set to SSH.
  5. Click Open.
  6. When prompted, log in as root, then enter the password provided by Shape.Host.

Step 3: Update Your System

apt update

Refreshes the list of available packages.

Terminal showing APT package management commands and output.

Step 4: Install Apache

apt install apache2

Installs the Apache web server.

Terminal showing APT package management commands and output.

Step 5: Start and Enable Apache

systemctl start apache2
systemctl enable apache2
systemctl status apache2

Starts Apache and enables it to launch on boot.

Terminal showing systemd service management commands or output.

Step 6: Install MariaDB

apt install mariadb-server

This installs the MariaDB database engine used by OpenCart.

Terminal showing PM2 application process management output.

Step 7: Start and Enable MariaDB

systemctl start mariadb
systemctl enable mariadb
systemctl status mariadb

Ensures the database service is running and enabled.

Terminal showing systemd service management commands or output.

Step 8: Create the OpenCart Database

mariadb

Inside the MariaDB shell, run:

CREATE DATABASE opencartdb CHARACTER SET utf8mb4 COLLATE utf8mb4_general_ci;
CREATE USER opencartdbuser@localhost IDENTIFIED BY 'your-password';
GRANT ALL ON opencartdb.* TO opencartdbuser@localhost WITH GRANT OPTION;
FLUSH PRIVILEGES;
exit

This creates the database and user for OpenCart.

Terminal showing SQL database and user configuration commands.

Step 9: Install PHP and Required Extensions

apt install php libapache2-mod-php php-intl php-mysql php-curl php-cli php-zip php-xml php-gd php-common php-mbstring php-xmlrpc php-json php-sqlite3 php-soap php-zip

These PHP modules are essential for OpenCart to function correctly.

Terminal showing APT package management commands and output.

Step 10: Download and Extract OpenCart

cd /tmp
wget https://github.com/opencart/opencart/releases/download/4.0.2.3/opencart-4.0.2.3.zip
apt install unzip
unzip opencart-4.0.2.3.zip

Gets the latest OpenCart release and extracts the files.

Terminal showing file download commands and transfer output.

Step 11: Move Files to the Web Directory

mv opencart-*/upload/ /var/www/opencart

Moves OpenCart files to Apache’s web root.

Step 12: Set Up Configuration Files

cp /var/www/opencart/config-dist.php /var/www/opencart/config.php
cp /var/www/opencart/admin/config-dist.php /var/www/opencart/admin/config.php

These are required for OpenCart to operate.

Step 13: Fix File Permissions

chown -R www-data:www-data /var/www/opencart

Ensures Apache can read and write to the OpenCart folder.

Terminal showing file ownership or permission commands.

Step 14: Create Apache Virtual Host

nano /etc/apache2/sites-available/opencart.conf

Paste this config and replace you-domain.com with your actual domain or IP:

<VirtualHost *:80>
  ServerName you-domain.com
  ServerAdmin contact@shape.host
  DocumentRoot /var/www/opencart

  <Directory /var/www/opencart/>
       Options FollowSymlinks
       AllowOverride All
       Require all granted
  </Directory>

  ErrorLog ${APACHE_LOG_DIR}/error.log
  CustomLog ${APACHE_LOG_DIR}/access.log combined
</VirtualHost>
Terminal showing web server configuration text.

Step 15: Enable the Site and Rewrite Module

a2ensite opencart.conf
a2enmod rewrite

Activates your new virtual host and the mod_rewrite module, which OpenCart needs.

Step 16: Restart Apache

systemctl restart apache2

Reloads the Apache server to apply changes.

Terminal showing systemd service management commands or output.

Step 17: Remove Installer Directory (after setup is complete)

rm -rf /var/www/opencart/install/

This is required for security once the web installer finishes.

Step 18: Access Your OpenCart Site

Visit:

http://your_domain.com

Follow the on-screen installer to finish configuration.

OpenCart installer license agreement.

An OpenCart installation wizard page should appear. Ensure all requirements are met and continue.

OpenCart pre-installation requirements check.

Next, enter the database name, create an account and password, and continue.

OpenCart installer database and administrator configuration form.

Your OpenCart site should be set up and ready to use.

OpenCart installation completion page with an installer-removal warning.

You’ve successfully installed OpenCart 4.0.2.3 on Debian 12 with Apache, PHP, and MariaDB — all steps based exactly on your real history and explained clearly.

This guide was designed for Shape.Host users. Shape.Host gives you:

  • Instant instance deployment
  • Full root access
  • Excellent performance for OpenCart and other PHP apps

Try it today at https://shape.host