Installing DbVisualizer
Downloading
Download DbVisualizer from https://www.dbvis.com/download/. Each download is marked with its format and whether it includes Java:
- SETUP With Java for Windows and Linux, and DMG With Java for macOS. We recommend these, since they include Java and work regardless of your Java setup.
- RPM With Java and DEB With Java, packages for Linux distributions that use them.
- ZIP Without Java for Windows and TAR.GZ Without Java for Linux, archives for users who already have a compatible Java installation.
Download the file for your operating system, then install it as described below. We recommend SETUP for Windows and Linux, and DMG for macOS. All files marked With Java on the download page include Java, so you don't need to install it separately.
Installing on Windows
SETUP
Run the setup file, dbvis_windows-x64_<version>_jre.exe, or dbvis_windows-arm64_<version>_jre.exe on an Arm computer, and follow the instructions. Setup adds DbVisualizer to the Start menu and can also create a desktop shortcut.
To uninstall, use Installed apps in the Windows settings.
ZIP
The ZIP archive doesn't include Java, so you need a compatible Java installation. See Starting the GUI from the Command Line (dbvisgui) for how to choose which Java DbVisualizer uses.
Unpack the archive, for example with the built-in extraction in Windows, and start DbVisualizer by running DbVisualizer\dbvis. The ZIP archive doesn't add DbVisualizer to the Start menu, create shortcuts or register it in Windows.
To uninstall, delete the DbVisualizer folder.
Installing on macOS
Open the DMG for your Mac, dbvis_macos-aarch64_<version>.dmg for Apple silicon or dbvis_macos-x64_<version>.dmg for Intel, and drag DbVisualizer to the Applications folder.
To uninstall, delete DbVisualizer from the Applications folder.
Installing on Linux
SETUP
Run the setup file in a terminal and follow the instructions:
sh dbvis_linux_<version>.sh
Setup can create a desktop shortcut. To uninstall, run the uninstall program in the installation folder.
TAR.GZ
The TAR.GZ archive doesn't include Java, so you need a compatible Java installation. See Starting the GUI from the Command Line (dbvisgui) for how to choose which Java DbVisualizer uses.
Unpack the archive. All files are placed in a folder named DbVisualizer:
tar xvfz dbvis_linux_<version>.tar.gz
Start DbVisualizer:
sh DbVisualizer/dbvisgui.sh
To uninstall, delete the DbVisualizer folder.
RPM
The RPM package includes Java.
Import the DbVisualizer signing key. You only need to do this once per computer:
sudo rpm --import https://dbvis.com/gpg-key.asc
Install the package:
sudo rpm -i dbvis_linux_<version>.rpm
To start DbVisualizer, click its icon in the applications menu or run dbvis in a terminal.
To uninstall:
sudo rpm -e dbvis
DEB
The DEB package includes Java. Install it, or use your package manager:
sudo dpkg -i dbvis_linux_<version>.deb
To start DbVisualizer, click its icon in the applications menu or run dbvis in a terminal.
To uninstall:
sudo dpkg --remove dbvis
Silent installation
The Windows and Linux setup files can install DbVisualizer without any user interaction, for example when you automate the installation. To do so, run the setup file with the -q argument. Setup then uses the default settings.
To install to a different folder than the default, add -dir followed by the folder:
dbvis_windows-x64_<version>_jre.exe -q -dir "D:\apps\DbVisualizer"
A silent installation doesn't show any output. To see the output, for example to troubleshoot a failed installation, add -console after -q.
Setup exits with code 0 if the installation succeeds, and 1 if it fails. To check the exit code:
Windows:
start /wait dbvis_windows-x64_<version>_jre.exe -q -console echo %errorlevel%start /waitmakes the command prompt wait for setup to finish.Linux:
sh dbvis_linux_<version>.sh -q -console echo $?
For more options, see the install4j documentation on command line options for installers.
Upgrading
When you install a new major version of DbVisualizer, your settings from the previous version are migrated the first time you start the new version.
Start the GUI before using dbviscmd
Settings are only migrated when you start the DbVisualizer GUI. Until you have done that, you can't run the command-line interface, dbviscmd, with the new version.