Install and Configure MySQL Workbench on Ubuntu 16.04 https://www.linode.com/docs/databases/mysql/install-and-con...

Community (https://www.linode.com/community/)

Questions Guides & Tutorials StackScripts GitHub Events

(https://www.linode.com(https://www.linode.com(https://www.linode.com(https://github.com(https://www.linode.com
/community/questions) /docs/) /stackscripts) /linode) /events)

Guides & Tutorials (https://www.linode.com/docs/)

» Database Management Systems (https://www.linode.com/docs/databases/)
» MySQL (https://www.linode.com/docs/databases/mysql/)
» Install and Configure MySQL Workbench on Ubuntu 16.04

Install and Con�gure  Search guides...

MySQL Workbench on
Ubuntu 16.04 In This Guide:
Updated Tuesday, August 8, 2017 by Linode Written by Linode

 RSS feed
Use promo code DOCS10 for Try this Guide 
(https://www.linode.com
$10 credit on a new account. /docs/index.xml)

 Contribute on GitHub
Report an Issue (https://github.com/linode/docs/issues 
/new?title=Install%20and%20Configure%20MySQL%20Workbench%20on%20Ubuntu%2016.04%20Proposed%20Changes
Monthly Guides
body=Link%3A https%3A%2F%2Ffanyv88.com%3A443%2Fhttps%2Flinode.com%2fdocs%2fdatabases%2fmysql%2finstall-and-configure-mysql-workbench-on
Update
ubuntu%2f%0A%23%23%20Issue%0A%0A%23%23%20Suggested%20Fix%0A&labels=inaccurate guide)
(https://github.com/linode/docs/blob/master/docs/databases/mysql/install-and-configure-mysql-workbench-on-ubuntu
Email address
/index.md) | Edit File (https://github.com/linode/docs/edit/master/docs/databases/mysql/install-and-configure-mysql-
workbench-on-ubuntu/index.md)

Sign Up
MySQL Workbench is a feature-rich graphical tool used to
model data, build SQL queries, manage MySQL servers,
and more. This guide will show you how to install
Workbench using the Ubuntu package manager.

Before You Begin

Update repositories and upgrade if necessary:

1 of 6 1/8/19, 12:27 AM
Install and Configure MySQL Workbench on Ubuntu 16.04 https://www.linode.com/docs/databases/mysql/install-and-con...

sudo apt update && sudo apt upgrade

Install MySQL Workbench

Install MySQL Workbench using the APT package
manager:

sudo apt install mysql-workbench

Run MySQL Workbench

Launch MySQL Workbench from the terminal:

mysql-workbench

To view more launch options from the command line

interface, use the --help option:

/usr/bin/mysql-workbench --help

MySQL Workbench shows this welcome screen on first run:

Con�gure MySQL Workbench

Use the built-in Workbench Preferences to adjust settings

such as targeted MySQL server version, font color, code
completion, and others.

To open the preferences, click on Edit , then Preferences in

the main menu:

2 of 6 1/8/19, 12:27 AM
Install and Configure MySQL Workbench on Ubuntu 16.04 https://www.linode.com/docs/databases/mysql/install-and-con...

Optional: Load a Sample

Database into MySQL Server
See the guide on how to Install a MySQL server on Ubuntu
14.04 (/docs/databases/mysql/install-mysql-on-ubuntu-
14-04/) or Debian 8 (/docs/databases/mysql/how-to-install-
mysql-on-debian-8/) for more information on creating or
logging into a MySQL server.

1. Access the MySQL server on your Linode via SSH

(/docs/getting-started/#connect-to-your-linode-via-ssh)
and download the sample Sakila database provided in
the MySQL documentation
(http://downloads.mysql.com/docs/sakila-db.tar.gz):

wget http://downloads.mysql.com/docs/sakila-db.tar.gz

2. Decompress the tar.gz file:

tar -xzvf sakila-db.tar.gz

3. Open MySQL Workbench on your local machine and

click + to create a new connection:

4. Create a Connection Name. Click the Connection

Method dropdown menu and select Standard TCP/IP
over SSH . Complete the credentials for SSH and

3 of 6 1/8/19, 12:27 AM
Install and Configure MySQL Workbench on Ubuntu 16.04 https://www.linode.com/docs/databases/mysql/install-and-con...

MySQL user login:

Note
The MySQL server default port should be 3306 on
l27.0.0.1 . If you wish to connect to another server with a
different port, update the inputs accordingly. See Deploy MySQL
Workbench for Database Administration (/docs/databases/mysql
/deploy-mysql-workbench-for-database-administration/) for more
information.

5. Under File, select Run SQL Script…. Select sakila-

schema.sql then click Run:

6. Repeat Step 5 for sakila-data.sql .

7. Under the Query1 tab, use the sample query below to

see a Result Grid of selected data:

USE sakila;
SELECT * FROM actors WHERE first_name LIKE 'A%';

4 of 6 1/8/19, 12:27 AM
Install and Configure MySQL Workbench on Ubuntu 16.04 https://www.linode.com/docs/databases/mysql/install-and-con...

The sample database provides a sandbox in which to test

configurations and show how to integrate them into your
workflow. MySQL Workbench offers a graphical interface to
view database models in addition to building queries. While
there are plenty of features, free and commercial,
lightweight alternatives are available, depending on needs
of the user. MySQL Workbench remains a great choice for
most database administration tasks.

More Information
You may wish to consult the following resources for
additional information on this topic. While these are
provided in the hope that they will be useful, please note
that we cannot vouch for the accuracy or timeliness of
externally hosted materials.

MySQL Workbench Manual (https://dev.mysql.com

/doc/workbench/en/)
Deploy MySQL Workbench for Database
Administration (/docs/databases/mysql/deploy-mysql-
workbench-for-database-administration/)

Join our Community

Find answers, ask questions, and help others.
(https://www.linode.com/community/questions/)

comments powered by Disqus (http://disqus.com)

This guide is published under a CC BY-ND 4.0 (https://creativecommons.org

/licenses/by-nd/4.0) license.

Write for Linode.

We're always expanding our docs. If you like to help people, can write, and have
expertise in a Linux or cloud infrastructure topic, learn how you can contribute
(/docs/contribute) to our library.

5 of 6 1/8/19, 12:27 AM
Install and Configure MySQL Workbench on Ubuntu 16.04 https://www.linode.com/docs/databases/mysql/install-and-con...

Get started in the Linode Cloud today.

Create an Account (https://manager.linode.com/session/sig

Overview Resources Company Legal Contact

(https://www.linode.com
(https://www.linode.com
(https://www.linode.com
(/agreement) Us
/linodes) /docs/) /about) (https://www.linode.com
Customer Agreement (/agreement)
Plans & Pricing (https://www.linode.com/pricing)
Guides & Tutorials About
(https://www.linode.com/docs/) /contact)
Us (https://www.linode.com/about)
Terms of Service (/tos)
855-4-LINODE (tel:+18554546633
Features (https://www.linode.com/linodes)
Speed Test (https://www.linode.com/speedtest)
Blog (https://blog.linode.com)
Privacy Policy (/privacy)
(855-454-6633) (tel:+18554546633
Add-Ons (https://www.linode.com/addons)
Community (https://www.linode.com/community)
Press (https://www.linode.com/press)
Acceptable Use Policy (/aup)
Intl.: +1 609-380-7100 (tel:+1609380
Managed (https://www.linode.com/managed)
Chat (https://www.linode.com/chat)
Referral System (https://www.linode.com/referrals)
Email us (mailto:[email protected]
Professional Services
System
(https://www.linode.com/professional-services)
Status (http://status.linode.com/)
Careers (https://www.linode.com/careers)

 (https://facebook.com/linode

© 2018 Linode, LLC

Security (https://www.linode.com/security)

Standards & Compliance (https://www.linode.com/compliance)

6 of 6 1/8/19, 12:27 AM