osCommerce is one of the oldest open-source e-commerce engines. Started in March 2000, it exists today as osCommerce 4 — the current version from UK-based osCommerce Ltd. Over more than two decades of active development the platform built an ecosystem of 7,000+ add-ons and evolved from a simple shopping cart into a full-featured solution supporting multi-site setups and multiple sales channels.
This guide covers who osCommerce 4 is for, how to install it on THE.Hosting VPS in any of 50+ locations — from Germany (Frankfurt) to Japan (Tokyo), from Netherlands (Meppel) to the US (New Jersey) — and how to configure the store for production. No fluff, practical steps and real commands throughout.
What Is osCommerce
osCommerce (Open Source Commerce) is a free PHP e-commerce platform under the GNU GPL license. No subscription fees, no product or order limits. You deploy it on your own server and have full control over the code, data, and infrastructure.
The current version is osCommerce 4. osCommerce Ltd is a UK company (Swindon, Wiltshire) actively maintaining development through 2025–2026: regular releases, official wiki documentation, and commercial support.
osCommerce 4 is built on the classic LAMP/LEMP stack. Supported PHP versions — 7.2 and higher (7.4 recommended; verify PHP 8.x extension compatibility for your specific version). Web server — Apache 2.4 (no extra configuration needed) or Nginx 1.x (requires additional setup). Database — MySQL or MariaDB 10.5+.
The platform supports multiple frontends (sales channels) from a single backend, dozens of built-in payment modules, flexible catalog management, multilingual and multi-currency support, SEO settings, and reporting. The add-on ecosystem on oscommerce.com offers thousands of free and commercial modules.
osCommerce vs competitors:
Compared to Zen Cart (also an osCommerce 2.x fork), version 4 offers a more modern architecture and native multi-site support. Against PrestaShop and OpenCart — osCommerce 4 is richer in built-in multi-channel sales management, though it trails in international community size and theme availability. WooCommerce requires WordPress; osCommerce is a standalone solution with no external CMS dependencies.
Who osCommerce 4 Is For
osCommerce 4 works best in several scenarios. First — businesses that need multiple online stores under one management umbrella: multi-site support out of the box lets you manage several frontends from a single admin panel. Second — projects with a history on osCommerce 2.x that need to migrate while keeping their existing add-on ecosystem. Third — companies where local data jurisdiction and full infrastructure control are critical.
The platform isn't the right fit if you need a marketplace with multiple sellers (CS-Cart Multi-Vendor handles that better) or if the priority is the fastest possible launch without technical knowledge.
osCommerce 4 System Requirements
Minimum requirements:
- PHP 7.2+ (7.4 recommended; verify PHP 8.x extension compatibility)
- MySQL 5.7+ or MariaDB 10.5+
- Apache 2.4+ or Nginx 1.x
- Minimum 1 GB RAM (2 GB+ recommended)
- Minimum 800 MB free disk space (for the installation archive and extraction)
PHP extensions: curl, ftp, gd, intl, mbstring, mysqli, opcache (optional but recommended), soap, xml, xmlrpc, xsl, zip.
Required php.ini parameters for osCommerce 4:
max_execution_time = 600
max_input_time = 600
max_input_vars = 10000
memory_limit = 256M
post_max_size = 64M
upload_max_filesize = 64M
max_file_uploads = 50
session.gc_probability = 1
session.gc_maxlifetime = 14400
expose_php = Off
Important for MySQL/MariaDB: osCommerce 4 requires strict mode to be disabled. Without this the installer will throw errors during database operations.
Preparing the VPS
After ordering VPS at THE.Hosting you receive root access via email. Connect:
ssh root@your-IP-address
Update the system:
apt update && apt upgrade -y
Create a working user:
adduser oscommerce
usermod -aG sudo oscommerce
Configure the firewall:
ufw allow OpenSSH
ufw allow 80/tcp
ufw allow 443/tcp
ufw enable
Set the timezone:
timedatectl set-timezone America/New_York
Installing the LAMP Stack
Apache
apt install apache2 -y
systemctl start apache2
systemctl enable apache2
Enable the required modules:
a2enmod rewrite headers
systemctl restart apache2
The rewrite module is needed for SEO-friendly URLs; headers is required for the X-Frame-Options header that osCommerce 4 demands.
MariaDB
apt install mariadb-server mariadb-client -y
systemctl start mariadb
systemctl enable mariadb
mysql_secure_installation
Disable MySQL strict mode — a mandatory step for osCommerce 4. Open the config:
nano /etc/mysql/mariadb.conf.d/50-server.cnf
Under the [mysqld] section add:
sql_mode = ""
Restart MariaDB:
systemctl restart mariadb
Create the store database:
mysql -u root -p
In the MySQL console:
CREATE DATABASE oscommerce CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER 'osc_user'@'localhost' IDENTIFIED BY 'strong_password';
GRANT ALL PRIVILEGES ON oscommerce.* TO 'osc_user'@'localhost';
FLUSH PRIVILEGES;
EXIT;
PHP 7.4
add-apt-repository ppa:ondrej/php -y
apt update
apt install php7.4 libapache2-mod-php7.4 php7.4-mysql php7.4-curl \
php7.4-gd php7.4-mbstring php7.4-xml php7.4-zip php7.4-intl \
php7.4-soap php7.4-xmlrpc php7.4-xsl php7.4-opcache php7.4-ftp -y
Configure php.ini:
nano /etc/php/7.4/apache2/php.ini
Apply the parameters from the system requirements section above. Restart Apache:
systemctl restart apache2
Installing osCommerce 4
Download the installation archive from the official site. Go to oscommerce.com → Products → Download for the current 4.x link, or use GitHub directly:
cd /tmp
wget https://github.com/osCommerce/osCommerce-V4/archive/refs/heads/main.zip -O oscommerce4.zip
Extract and move to the web server directory:
apt install unzip -y
unzip oscommerce4.zip -d /tmp/osc-src
mkdir -p /var/www/oscommerce
cp -r /tmp/osc-src/osCommerce-V4-main/. /var/www/oscommerce/
Make sure you have at least 800 MB free — the installation requires it for archive extraction and setup.
Set file permissions:
chown -R www-dаta:www-data /var/www/oscommerce
find /var/www/oscommerce -type d -exec chmod 755 {} \;
find /var/www/oscommerce -type f -exec chmod 644 {} \;
chmod 666 /var/www/oscommerce/includes/configure.php
chmod 666 /var/www/oscommerce/admin/includes/configure.php
Apache Virtual Host
nano /etc/apache2/sites-available/oscommerce.conf
Content:
<VirtualHost *:80>
ServerName yourstore.com
ServerAlias www.yourstore.com
DocumentRoot /var/www/oscommerce
<Directory /var/www/oscommerce>
AllowOverride All
Require all granted
Options -Indexes
</Directory>
Header always set X-Frame-Options SAMEORIGIN
ErrorLog ${APACHE_LOG_DIR}/oscommerce-error.log
CustomLog ${APACHE_LOG_DIR}/oscommerce-access.log combined
</VirtualHost>
Enable the site:
a2ensite oscommerce.conf
a2dissite 000-default.conf
systemctl restart apache2
SSL Certificate
apt install certbot python3-certbot-apache -y
certbot --apache -d yourstore.com -d www.yourstore.com
osCommerce 4 Web Installer
Open https://yourstore.com/install/ in your browser — the setup wizard launches.
On the first screen accept the license agreement and click "Accept and Start Installation". The installer runs a server requirements check — all items in the "Current" column must match "Required". If strict mode is disabled correctly and all PHP extensions are installed, this check passes cleanly.
On the next step enter database credentials: host localhost, database name oscommerce, user and password. Click "Install Database" — the installer creates all tables.
Fill in the store details: name, admin email, currency, country. Create an administrator account.
After completing installation, delete the install/ folder immediately — leaving it is a critical security vulnerability:
rm -rf /var/www/oscommerce/install
The admin panel is accessible at https://yourstore.com/admin/.
Configuring the Store
After installation go to Admin → Configuration → My Store. Set the core parameters: store name, owner, email, country and zone (for tax calculation), measurement units.
Multi-site / Sales Channels — one of osCommerce 4's key features. Under Admin → Sales Channels you create additional frontends with separate domains, product catalogs, and design settings, all managed from the single admin panel.
Payment modules — Admin → Modules → Payment. osCommerce 4 includes dozens of built-in integrations: PayPal, Stripe, Authorize.Net, Square, 2Checkout, and others. Each is enabled and configured through the interface without editing code.
Shipping — Admin → Modules → Shipping. Flat rate, weight-based calculation, UPS, FedEx, USPS, Royal Mail integrations. Configure geographic zones and rates per zone.
Languages and currencies — Admin → Localization. Download a language pack and install it through the admin panel. For multi-currency stores configure exchange rates and the primary currency binding.
Email — configure SMTP under Admin → Configuration → Email. Use an external SMTP provider (SendGrid, Mailgun, AWS SES) instead of local sendmail for reliable transactional email delivery.
Performance Tuning
OPcache — enable in /etc/php/7.4/apache2/php.ini:
opcache.enable = 1
opcache.memory_consumption = 128
opcache.max_accelerated_files = 10000
opcache.revalidate_freq = 60
Compression — add to the <VirtualHost> block in your Apache config:
<IfModule mod_deflate.c>
AddOutputFilterByType DEFLATE text/html text/css application/jаvascript
</IfModule>
Caching — osCommerce 4 supports file-based caching out of the box. For higher-traffic projects consider Varnish in front of Apache or Redis for sessions.
MariaDB — for large catalogs increase innodb_buffer_pool_size in the MariaDB config to 50–70% of available RAM:
innodb_buffer_pool_size = 1G
Choosing a VPS at THE.Hosting
For development and a test store, Ferrum VPS with 2 vCPU / 2 GB RAM / 40 GB NVMe is enough — available in all 50+ locations from €12/month.
For a production store with moderate traffic — Standard VPS with 4 vCPU / 4–8 GB RAM / 80 GB NVMe. Multi-site setups with several frontends benefit from 8 GB RAM or more.
European market: Germany (Frankfurt) — financial hub, GDPR compliance; Netherlands (Meppel) — Europe's largest internet exchange; UK (London) — UK-jurisdiction data storage, relevant given osCommerce Ltd's British registration; France (Paris) — for French-speaking audiences.
Asian market: Japan (Tokyo) — lowest latency for East Asia; Hong Kong — gateway to China and Southeast Asia; South Korea (Seoul) — high-speed regional infrastructure.
American audience: USA (New Jersey, Secaucus) — East Coast; Canada (Toronto) — Canadian market with local jurisdiction; Brazil (São Paulo) — Latin America's largest market.
CIS and Eastern Europe: Moldova (Chișinău) — Dedicated servers available; Poland (Warsaw) — Central Europe; Finland (Helsinki) — minimal latency for Russia.
For stores with heavy traffic or multi-site configurations, go straight to Dedicated Server — available in Finland, France, Germany, Moldova, Netherlands, USA, and UK.
Common Issues and Solutions
Database installation error — strict mode. The most frequent problem. Confirm that sql_mode = "" is set under [mysqld] in the MariaDB config and the service has been restarted. Verify with: mysql -u root -p -e "SELECT @@sql_mode;" — the result should be empty.
ModSecurity blocks admin requests. If ModSecurity is installed, it may block legitimate osCommerce requests. Either disable it or add a whitelist rule exempting the /admin/ directory from all ModSecurity rules.
White screen or PHP errors. Check the log: tail -f /var/log/apache2/oscommerce-error.log. Most commonly a missing PHP extension (soap, xmlrpc) or incorrect file permissions on the config files.
Installer shows red items. If extensions fail the check, confirm you installed them for the correct PHP version (7.4, not the system default). Check active extensions: php7.4 -m.
Slow page loads. Enable OPcache, confirm expose_php = Off, and disable unused Apache modules (apache2ctl -M — audit the loaded module list).
Ready to launch your store on osCommerce?
On THE.Hosting VPS with NVMe drives and root access you get complete control over server configuration — tune PHP, MariaDB, and Apache exactly as your store requires. Choose from 50+ locations closest to your audience.
FAQ:
Is osCommerce free? Yes, completely. GNU GPL license — download, install, and use in commercial projects at no cost. You only pay for hosting and your domain. Some commercial themes and modules are paid, but core functionality for launching a store is free.
How different is osCommerce 4 from 2.x? Substantially. osCommerce 4 is essentially a rewritten platform with modern architecture, multi-channel sales support, an updated admin interface, and PHP 7.4+ compatibility. Versions 2.3.x and 2.4.x are legacy branches that only run on old PHP (5.x–7.1) and are no longer officially supported.
How many products can osCommerce handle? On a properly configured VPS with 4–8 GB RAM and an NVMe disk — tens of thousands of SKUs comfortably. Catalogs of 100,000+ items require query optimization, MariaDB indexing, and a dedicated server.
Can I migrate from Zen Cart or PrestaShop? No official migration tools exist. Products transfer via CSV import; orders and customer history via SQL or third-party migration services. For migrations from osCommerce 2.x, community-contributed scripts exist on the oscommerce.com forum.
Does osCommerce support multiple stores? Yes — this is one of the key features of version 4. Multiple sales channels (frontends) with different domains, product catalogs, and design settings are all managed from a single admin panel.
THE.Hosting Useful Links:
- VPS in Germany (Frankfurt)
- VPS in Netherlands (Meppel)
- VPS in UK (London)
- VPS in USA (New Jersey)
- Dedicated Servers
- Knowledge Base
osCommerce Resources: