Skip to content

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 /wait makes 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.