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 Web site.

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, MySQL Connections. For additional information about installing a MySQL server, see Installing and Upgrading MySQL.

    Data modeling does not require a MySQL server connection.

  • 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 OS X, 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 4.0 Framework

  • Microsoft Visual C++ 2013 Redistributable Package (MSVC2013)


    The 2010 version was used in previous editions of MySQL Workbench 6.

  • Windows 7 and above


    MySQL Workbench 6.1 supports earlier versions of Windows, including Vista

Download this Manual
PDF (US Ltr) - 14.7Mb
PDF (A4) - 14.7Mb
EPUB - 12.8Mb
HTML Download (TGZ) - 12.7Mb
HTML Download (Zip) - 12.8Mb
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.