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.