MySQL Workbench Manual  /  Installation  /  System Requirements

2.1 System Requirements

MySQL Workbench is available on a number of operating systems and platforms. For information about those platforms that are officially supported, see on the MySQL website.

General Requirements

General requirements and considerations that apply to all operating systems.

  • MySQL server: Although it is not required, MySQL Workbench is designed to have either a remote or local MySQL server connection. For additional information about connecting to a MySQL server, see Chapter 5, Connections in MySQL Workbench. For additional information about installing a MySQL server, see Installing and Upgrading MySQL.

    Data modeling does not require a MySQL server connection.

    Some features take advantage of MySQL server features, and as such, they require more recent versions of MySQL Server. For example, the Performance Dashboard requires MySQL Server 5.6 or higher.

  • Simultaneous client connections: Opening a MySQL connection from the MySQL Workbench home page opens a new connection tab in MySQL Workbench for that connection. Each of these tabs requires two MySQL connections to perform basic tasks, such schema discovery and SQL execution. Additionally, performing management related tasks, such as Server Status, requires two additional MySQL connections. Essentially, this means that each MySQL connection tab in MySQL Workbench requires four available connections to MySQL. For additional information about "Too many connection" related errors, see Too many connections.

    This connection requirement doubles with each connection tab opened in MySQL Workbench, even if the two connection tabs point to the same MySQL server. SQL editor tabs share their connections, so having multiple SQL editor and SQL results tabs does not affect the number of required connections.


On startup, the application checks the OpenGL version and chooses between software and hardware rendering. To determine which rendering method is being used, open the Help menu and choose the System Info item.

Requirements for Linux

  • The requirements for Linux are embedded within their respective packages. Use the platform specific tool (for example, yum or apt) to install the package and their dependencies.

  • The "Save password in keychain" functionality requires gnome-keyring to store the passwords. Note that on KDE systems, the gnome-keyring daemon is not started by default.

  • For Linux and macOS, the MySQL server administration features require sudo privileges to execute several commands. The sudo user must be capable of executing the following system commands:


    Additionally, the sudo user must keep the HOME environment variable when executing system commands, which means adding the following to /etc/sudoers:

    env_keep +="HOME"

    For MySQL Workbench to execute MySQL Enterprise Backup commands, the sudo user must also be able to execute the MySQL Enterprise Backup binary.

Requirements for Windows

  • Microsoft .NET Framework 4.5

  • Microsoft Visual C++ 2015 Redistributable Package


    The 2013 version was changed to 2015 with MySQL Workbench 6.3.9.

  • Windows 7 and above


    MySQL Workbench 6.1 supports earlier versions of Windows, including Vista.

User Comments
  Posted by Gautam Sharma on December 17, 2013
In the note on "Dependencies for Compiling in Windows":
(1) its not clear if this is what is required for installation via msi (needs MS VC++2010 RP) and zip (needs .NET v4,9,39319)
(2) it would've been good to actually have a URL instead of making users run around
Sign Up Login You must be logged in to post a comment.