MySQL Workbench Manual  /  Installation  /  Command-Line Options

2.2 Command-Line Options

In addition to platform-specific command-line options, MySQL Workbench has the following command-line options:


On Microsoft Windows, the command-line options contain one leading dash instead of two. For example, use -log-level for Microsoft Windows and --log-level for Linux and macOS.

  • --log-level level: Controls the verbosity level for logging output from Workbench.

    With increasingly levels of verbosity, the valid values for level are: error, warning, info, debug1, debug2, and debug3.

    The location of the generated log files, such as wb.log, are as follows:

    Table 2.1 Default location of generated MySQL Workbench log files

    Platform Default location
    Linux ~/.mysql/workbench/log/
    macOS ~/Library/Application Support/Workbench/log/
    Microsoft Windows C:\Users\user_name\AppData\Roaming\MySQL\Workbench\log\

  • --admin instance: Open an administration tab to the named MySQL instance.

  • --upgrade-mysql-dbs: Open the Migration Wizard tab.

  • --migration: Open the Migration Wizard tab.

  • --log-to-stderr: Also log to stderr.

  • --version: Show MySQL Workbench version number and exit.

  • --verbose, -v: Enable diagnostics output.

  • --query [connection|connection_string]:

    • Empty: Open a query tab and prompts for a connection.

    • Connection: Open a named connection.

    • Connection_string: Create a connection based on the entered connection string, which should be in the form $USER@$HOST:$PORT.

  • --model modelfile: open the given EER model file.

  • --script script: Open the given SQL file in a connection, typically used with the --query parameter.

  • --run code: Execute the given code using the default language for GRT shell.

  • --run-python script: Execute the given code in Python.

  • --run-script file: Execute Python code from a file.

  • --open file: Open the given file at startup. Deprecated, so instead use specific types such as --script or --model.

  • --quit-when-done: Quits MySQL Workbench after --script or --run finishes.

User Comments
User comments in this section are, as the name implies, provided by MySQL users. The MySQL documentation team is not responsible for, nor do they endorse, any of the information provided here.
Sign Up Login You must be logged in to post a comment.