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

:::tip
If you’re unsure about your database credentials, check your hosting control panel or contact your hosting provider.
:::

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.

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][email protected] 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:

1. Update env.php

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

2. Update .htaccess (Apache)

Modify the rewrite rule to include your subdirectory:

RewriteRule ^ vvveb/index.php [L]

Update both:

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

3. 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;

:::caution
Subdirectory installs are not recommended for multi‑site setups. All sites would inherit the subdirectory path.
:::

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)

If you want, I can also create a troubleshooting section, a server requirements page, or a step‑by‑step illustrated guide to complement this documentation.

"Install Xampp