Vvveb is designed to be easy to install on any standard hosting environment. You can install it on shared hosting, VPS, local development environments, or using Docker.

Quick Start

  1. Download the latest release from
    https://vvveb.com
  2. Unzip the archive.
  3. Upload the contents to your server using FTP, SFTP, or your hosting control panel.
  4. Create a database (MySQL/MariaDB).
  5. Visit your website URL (e.g., http://localhost or https://yourdomain.com) to launch the installation wizard.

You can also install using Docker: see the Docker installation guide.

Step 1 - Database Configuration

Create a new MySQL/MariaDB database using phpMyAdmin or your hosting control panel.
(If you choose SQLite, you can skip this step.)

When the installer opens, enter your database details:

  • Database engine
  • Host (usually 127.0.0.1 or localhost)
  • Database name
  • Username
  • Password

Install database info

Step 2 - Website & Admin Setup

Next, enter your site information:

  • Website name
  • Admin email
  • Admin username
  • Admin password
  • Optional: custom admin login path
  • Choose whether to enable ecommerce
  • Select your default theme (Landing or Blog)
  • Select your homepage

After completing the form, click Finish install to complete setup.

Install site info

For maximum security, configure your web server’s document root to point to:

/vvveb/public/

instead of the main /vvveb/ directory.

This ensures:

  • Only a single public PHP file (index.php) is exposed
  • All core, plugin, and system files remain inaccessible from the web
  • Reduced attack surface and improved protection against plugin vulnerabilities

Protecting the Admin Login

You can also set a custom admin login path (e.g., /vadmin-xyz123) to reduce brute‑force attempts.
This feature works only when the document root is set to /public.

Installing via CLI

You can install Vvveb from the command line using:

php cli.php install module=index host=127.0.0.1 engine=mysqli user=root password= database=vvveb admin[email]=admin@vvveb.com admin[username]=admin admin[password]=123456 subdir=/vvveb

This is useful for automated deployments or scripted setups.

Installing in a Subdirectory

Vvveb supports subdirectory installations (e.g., https://example.com/vvveb/).

If automatic detection fails, you can configure it manually:

Update env.php

defined('V_SUBDIR_INSTALL') || define('V_SUBDIR_INSTALL', '/vvveb');

Update .htaccess (Apache)

Modify the rewrite rule to include your subdirectory:

RewriteRule ^ vvveb/index.php [L]

Update both:

  • /vvveb/.htaccess
  • /vvveb/public/.htaccess

Update nginx.conf (Nginx)

Add your subdirectory before index.php:

try_files /page-cache/$host$cache_uri /page-cache/$host$cache_uri/index.html $uri $uri/ /subdir/index.php$is_args$args;

Installing with XAMPP/WAMP (Local Development)

If you prefer a local environment without manual server configuration:

Place Vvveb inside your local server’s htdocs or www directory and open:

http://localhost/vvveb

Vvveb includes ready‑to‑use configuration files for:

  • Apache (.htaccess)
  • Nginx (nginx.conf)

These are located in the root folder if you want to configure your server manually.

After Installation

You can log in to your dashboard at:

  • http://localhost/admin
  • https://yourdomain.com/admin

(or your custom admin path if you set one)

For the recommended server setup steps see Apache configuration and Nginx configuration, and for a guided walkthrough see the step-by-step tutorial.

Install Xampp