Skip to content
Guide · Install a database

How to Install MySQL on Windows (Community Server + Workbench)

Installing MySQL on Windows has changed. MySQL Installer, the single setup program many older tutorials describe, only covers the MySQL 8.0 series; for current versions MySQL documents a two-part route instead: install MySQL Community Server from its own MSI, then configure it with MySQL Configurator, which the MSI installs and offers to start. This guide follows that route, then adds MySQL Workbench, a first schema, the errors beginners meet and a short note on MariaDB.

Steps checked 8 October 2026 against the official documentation for each product. Versions covered: MySQL Community Server 9.7.2 LTS (also 26.7 Innovation and 8.4.11 LTS), MySQL Workbench 26.7.0, MySQL Installer 8.0.46 (8.0 series only). Next review due April 2027. Installers, versions and download pages change; follow the official page if a step differs.
Short answer
  • Download MySQL Community Server from dev.mysql.com/downloads/mysql: choose Microsoft Windows and the Windows (x86, 64-bit) MSI Installer. MySQL runs on 64-bit Windows only.
  • MySQL Installer is not offered for current versions: MySQL says 8.0 is the final series with MySQL Installer, and that from MySQL 8.1 you use each product's own MSI or Zip archive.
  • After the server MSI finishes, run MySQL Configurator. It sets the root password, the port (3306 by default), the Windows service and the my.ini file; the server does not start until it is configured.
  • Install MySQL Workbench 26.7.0 separately from its own MSI on the Workbench download page.
  • Versions on offer: 26.7 (the first calendar-versioned Innovation release), 9.7.2 LTS and 8.4.11 LTS. For learning, an LTS release changes least between updates.
How we know: Research-based: download options, the Windows install route, MySQL Configurator screens and error messages were checked against the MySQL 9.7 Reference Manual, the MySQL Workbench Manual and the dev.mysql.com download pages on 8 October 2026. We confirmed on the MySQL Installer download page that MySQL Installer stops at the 8.0 series. We have not run these installers for this guide and no screenshots are shown; screen and option names are the ones MySQL documents.

MySQL download: which package you need in 2026

The official MySQL Community download pages are at dev.mysql.com/downloads. MySQL Community Server is free to download; MySQL Enterprise Edition is a separate commercial product, which this guide does not cover.

On the MySQL Community Server page, Select Version lists 26.7.0, 9.7.2 LTS, 8.4.11 LTS and 8.0.46, and Select Operating System offers Microsoft Windows. The Windows packages are a Windows (x86, 64-bit), MSI Installer, a ZIP archive, and a larger ZIP of debug binaries and the test suite you do not need. The Reference Manual states that MySQL is available for 64-bit Windows only and that the server needs the Microsoft Visual C++ 2019 Redistributable installed first.

MySQL Server versions on the Community download page (8 October 2026)
VersionTrackWhat the manual says about it
26.7.0InnovationFirst release using calendar versioning (YY.M); Innovation releases are supported until the next Innovation release.
9.7.2 LTSLong-term supportMySQL 9.7 is the last release line with the old sequential numbering. LTS series follow Oracle Lifetime Support: 5 years premier plus 3 years extended support.
8.4.11 LTSLong-term supportThe previous LTS series; upgrades go 8.4 LTS to 9.7 LTS without skipping a series.
8.0.46Older seriesThe last series that MySQL Installer supports.

What happened to MySQL Installer

Older guides start with a mysql-installer-community file that installs the server, Workbench, Shell and connectors in one go. The MySQL Installer download page now carries this note: MySQL 8.0 is the final series with MySQL Installer, and from MySQL 8.1 you use a MySQL product's MSI or Zip archive, with MySQL Server 8.1 and later bundling MySQL Configurator. The page still offers MySQL Installer 8.0.46, but only for the 8.0 series. The MySQL Workbench manual still describes MySQL Installer as the recommended route; for Workbench 26.7 use the standalone MSI instead.

Install MySQL Community Server with the MSI

The Reference Manual calls the MSI the simplest and recommended method:

  1. Install the Microsoft Visual C++ 2019 Redistributable from the Microsoft Download Center if it is not already present.
  2. On the MySQL Community Server download page, select your version (for example 9.7.2 LTS) and Microsoft Windows, then download the MSI Installer. You can verify it with the MD5 checksum and GnuPG signature shown beside the link.
  3. Run the MSI. It installs the server and MySQL Configurator and adds a MySQL group to the Windows Start menu. The default folder is C:\Program Files\MySQL\MySQL Server 9.7; the Custom setup type lets you choose another location.
  4. When the MSI finishes, it offers to run MySQL Configurator. Run it straight away: the manual notes the server will not start until it is configured.

For scripted installs the manual documents standard msiexec options, run as Administrator:

Silent MSI install with a log file (example from the MySQL 9.7 manual)
msiexec /i "C:\mysql\mysql-9.7.2-winx64.msi" /qn /lv "C:\mysql\install.log"

Configure MySQL with MySQL Configurator (root password, port, service)

MySQL Configurator replaces the configuration screens that used to live inside MySQL Installer. You can also start it later from the Start menu, or run mysql-configurator.exe from the server's bin folder, to reconfigure the server. As documented, the steps are:

  1. Type and Networking. Choose a Server Configuration Type: Development (your own workstation, least memory) suits learning. TCP/IP is selected by default with the classic port 3306 and the X Protocol port 33060, and Open Windows Firewall port for network access is ticked. If a port is already in use, Next stays disabled until you choose another.
  2. Accounts and Roles. Set the root account password; this is required, and you will need it again to reconfigure. You can optionally add other MySQL user accounts with predefined roles such as DB Admin.
  3. Windows Service. Configure MySQL server as a Windows service is selected by default, with the service set to start at system startup and run as the Standard System Account. Note the Windows Service Name; you need it to start or stop the server from the command line.
  4. Server File Permissions. By default only the service account and the Administrators group get access to the data folder under C:\ProgramData\MySQL.
  5. Sample Databases. Optionally install the sakila and world sample databases, which are useful practice data.
  6. Apply Configuration. Choose Execute and watch each step turn green; the Log tab shows details if one fails.

The Configurator writes the settings to my.ini. Logging and advanced options such as the server ID only appear if you tick Show Advanced and Logging Options on the first screen.

MySQL command line client: PATH and first connection

The mysql command line client is in the server's bin folder. To run it from any prompt, the manual describes adding the folder to the system Path variable through System Properties, Advanced, Environment Variables, for example C:\Program Files\MySQL\MySQL Server 9.7\bin. It warns you to edit PATH carefully, and not to add the folder if you run several MySQL servers on one machine. Open a new prompt afterwards.

From a new prompt, connect as root and enter the password you set in the Configurator when asked. Once you have set a root password, the manual notes that client programs need the matching -u and -p options:

Connect as root and check the server (Windows command prompt)
mysql -u root -p
mysqladmin -u root -p version
Start or stop the Windows service (use the service name set in MySQL Configurator)
NET START mysqld_service_name
NET STOP mysqld_service_name

Install MySQL Workbench and create your first schema

MySQL Workbench is a separate download at dev.mysql.com/downloads/workbench; the current release is 26.7.0, offered as a Windows (x86, 64-bit) MSI and a ZIP archive. The Workbench manual lists the Microsoft Visual C++ 2015-2022 Redistributable and .NET Framework 4.5.2 as prerequisites, says the MSI needs Administrator or Power User privileges, and recommends the Complete setup type. For platform details and the macOS and Linux packages, see the MySQL Workbench install guide.

Once Workbench is connected to your local server as root, you can run SQL in its editor exactly as in the command line client. In MySQL a schema and a database are the same thing, so creating your first schema is a CREATE DATABASE statement. The manual's tutorial uses a database called menagerie:

Create and select a first database, then add a table (MySQL)
CREATE DATABASE menagerie;
USE menagerie;
SELECT DATABASE();

CREATE TABLE pet (name VARCHAR(20), owner VARCHAR(20),
       species VARCHAR(20), sex CHAR(1), birth DATE, death DATE);
SHOW TABLES;

Lettercase on Windows

The manual notes that database and table names are case-sensitive on Unix but not on Windows, and recommends always using the same lettercase you used when creating them. MySQL Configurator sets lower_case_table_names to 1 by default on Windows, so names are stored in lowercase. Keeping names lowercase from the start avoids surprises if you later move a database to a Linux server.

Common MySQL install errors on Windows

The manual's first troubleshooting step is the error log in the data directory, and it suggests starting the service with NET START from a command prompt to see startup messages. Reinstalling without first stopping and removing the old MySQL service is another documented cause of failures; stop it and run SC DELETE with the old service name before installing again.

Errors documented in the MySQL Reference Manual
ErrorWhat it meansWhat to check
ERROR 2003 (HY000): Can't connect to MySQL server on 'localhost' (10061)The connection was refused: nothing is listening on that host and port.Start the MySQL service, confirm it has network connections enabled and that you use the configured port (3306 by default). 10061 is the same Windows socket error explained for SQL Server in error 10061.
ERROR 1045 (28000): Access denied for user 'root'@'localhost'The server was reached but rejected the user or password.Use the root password set in MySQL Configurator, and add -p so the client asks for it.
ERROR 1044 (42000): Access denied for user ... to databaseThe account lacks the privilege to create or use that database.Connect as root, or grant the account the privileges it needs.
System error 1067 has occurred. with Table 'mysql.user' doesn't existThe service cannot find its data directory or system tables.Check basedir and datadir in my.ini, and remove old configuration files left by a previous install.

MariaDB note and next steps

MariaDB is a separate open source database with its own Windows MSI from mariadb.org/download, whose default service name is MariaDB. MySQL Configurator and MySQL Workbench are MySQL products, so check MariaDB's own documentation rather than assuming they apply. See MariaDB vs MySQL before choosing.

With MySQL running, continue with the SQL beginner course and the SQL exercises, or compare engines in MySQL vs PostgreSQL. Oracle also documents Docker images for MySQL, but notes they are built for Linux and other platforms are unsupported; see the related MySQL in Docker guide below.

Frequently asked questions

Is MySQL free to download?

Yes. MySQL Community Server and MySQL Workbench Community are free downloads from dev.mysql.com. Oracle's MySQL Enterprise Edition is a separate commercial product.

Is MySQL Installer still available for Windows?

Only for MySQL 8.0. The download page states that 8.0 is the final series with MySQL Installer and that from MySQL 8.1 you install each product from its own MSI or Zip archive. Current servers (8.4, 9.7, 26.7) bundle MySQL Configurator instead.

Which MySQL version should I download?

For learning, an LTS release such as 9.7.2 LTS changes least between updates. The 26.7 Innovation release has the newest features but is supported only until the next Innovation release. If you are matching a hosting provider or course, use its version.

How do I set the MySQL root password on Windows?

MySQL Configurator asks for it on the Accounts and Roles step; a root password is required. To change it later, run MySQL Configurator again from the Start menu.

Where is the MySQL command line client download?

It is part of MySQL Community Server: the mysql client is installed in the server's bin folder together with mysqladmin and mysqldump. Add the bin folder to PATH to run it from any prompt.

Sources

Checked 8 October 2026.

How we research guides: our editorial method. We link only to official downloads and never host installers.

Database installed?

Write your first queries with the free beginner course, then practise on real problems.