Installing dbxapp

Tutorial · Installation

Install dbxapp step by step

In this tutorial, you set up a new dbxapp installation in a controlled manner. After each section, check a visible result before proceeding.

Result At the end, you can log in with a personal administrator password and complete a successful quick test.

1. Preparation

Check the system requirements

Before copying the files, make sure that the target server meets the mandatory requirements.

Test	Requirement	Verification
PHP	Version 8.2 or later	`php -v` or server overview
Extensions	Session, PDO, JSON, Filter, Hash and OpenSSL	`php -m`
Autoload	`dbx/vendor/autoload.php` Existing	Verification file in package
Write permissions	`files`, `tmp` and local configuration writable	Assistant system check
HTTPS	Active for production	Address starts with `https://`

Prepare security and deployment

For an existing environment, first back up files, local configuration, and all databases.
For a new installation use a dedicated, empty web directory.
Prepare a personal admin password with at least twelve characters.

2. Provide files

Unpack the release

Copy the packageUnpack the full release to the destination directory. Do not copy files from an older version.
Configure the document rootThe web server points to the directory in which index.php is located.
Limit permissionsMake only runtime directories and local configuration writable; Keep source code read-only during operation.
Open the front pageThe new installation will automatically redirect to the installation assistant.

Verification point

The assistant shows step 1 “System Check”. A normal website or blank page would not be correct at this point.

3. Configure the installation

Step 1 to 3: System, website and data storage

Fix all red mandatory errors in the system check.
Set website title, brand name, default language, time zone and designs.
Select DB3 for direct entry or a tested PDO target for a central database server.

Step 4 to 6: Data, administration and e-mail

Create structures only after successful database connection. Start a data transfer only after additional confirmation.
For admin Enter the prepared personal password twice.
For the first test, the mail mode internal or store a fully tested SMTP configuration.

Step 7: Review and completion

Check website, language, time zone, database mode, administrator and mail mode. Secrets shall not appear in plain text in the summary. Complete the installation.

4. Complete the installation

Sign-in and quick test

Sign inWith admin and the password assigned in step 5.
Open self-testIn the admin menu System → System Self-Test Select.
Run the quick testThe run must complete without errors. Review details about skipped optional tools.
Plan the full testBefore the production launch, also run the full test catalog.

Acceptance protocol

Verification	Passed if ...
Sign-in	The personal administrator password works and no standard password is active.
Configuration	Design, language, time zone, mail mode and database bindings.
Quick test	All mandatory checks are green and the run is completed.
Backup	Configuration, files and bound databases are backed up externally.

5. Resolving typical errors

The assistant keeps reopening

Write permissions and content of dbx/modules/dbx/cfg/config.local.php check. The completed installation saves there locally install = 0.

The database connection fails

Verification PDO driver, host, port, database name and user rights. Without a successful connection, do not start schema synchronization or data transfer.

A blank page appears

PHP version, mandatory modules, vendor/autoload.php, web server log and files/dbxError.log check.