Requirements

Requirements

DBNova runs anywhere PHP and MySQL run. It is developed on macOS and deployed on Linux.

#Server

Component Requirement
OS Linux (Ubuntu 22.04+ / Debian 12) in production, macOS for development
PHP 8.3 or newer (CLI and FPM)
MySQL server 8.0+ (5.7 best-effort), on the same machine or network
MySQL client tools mysql and mysqldump, ideally the same version as the server
Node 20+ (only to build the front end)
Queue worker php artisan queue:work, kept running by supervisor or systemd
Scheduler cron running php artisan schedule:run every minute
Disk Free space of at least 2× your largest import, plus your export files

#PHP extensions

pdo_mysql, pdo_sqlite, mbstring, openssl, zip, zlib, fileinfo, ctype, tokenizer, xml, pcntl and posix.

pcntl and posix let the worker stop a running mysql client when you cancel an import.

#Finding the MySQL client binaries

DBNova needs the full path to real binaries, not shell aliases:

command -v mysql mysqldump
Install Path
Linux packages /usr/bin/mysql
macOS (Oracle installer) /usr/local/mysql/bin/mysql
Homebrew /opt/homebrew/bin/mysql
MAMP /Applications/MAMP/Library/bin/mysql80/bin/mysql

Tip The System page inside DBNova shows the version each binary reports, so you can confirm they match your server.

0 views Something unclear? Open an issue on GitHub