Documentation Home
MySQL Installation Guide
Related Documentation Download this Excerpt
PDF (US Ltr) - 2.4Mb
PDF (A4) - 2.4Mb


MySQL Installation Guide  /  Installing MySQL

Chapter 1 Installing MySQL

This chapter describes how to obtain and install MySQL. A summary of the procedure follows and later sections provide the details. If you plan to upgrade an existing version of MySQL to a newer version rather than install MySQL for the first time, see Chapter 10, Upgrading MySQL, for information about upgrade procedures and about issues that you should consider before upgrading.

If you are interested in migrating to MySQL from another database system, see MySQL 8.0 FAQ: Migration, which contains answers to some common questions concerning migration issues.

Installation of MySQL generally follows the steps outlined here:

  1. Determine whether MySQL runs and is supported on your platform.

    Please note that not all platforms are equally suitable for running MySQL, and that not all platforms on which MySQL is known to run are officially supported by Oracle Corporation. For information about those platforms that are officially supported, see https://www.mysql.com/support/supportedplatforms/database.html on the MySQL website.

  2. Choose which distribution to install.

    Several versions of MySQL are available, and most are available in several distribution formats. You can choose from pre-packaged distributions containing binary (precompiled) programs or source code. When in doubt, use a binary distribution. Oracle also provides access to the MySQL source code for those who want to see recent developments and test new code. To determine which version and type of distribution you should use, see Section 2.2, “Which MySQL Version and Distribution to Install”.

  3. Choose which track to install.

    MySQL offers a bugfix track (such as MySQL 8.4), and an innovation track (today it's MySQL 9.0) and each track addresses different use cases. Both tracks are considered production-ready and include bug fixes, while innovation releases also include new features and potential for modified behavior.

    A bugfix track upgrade includes point releases, such as MySQL 8.4.x upgrading to 8.4.y, while innovation track releases typically only have minor releases, such as MySQL 9.0.0 upgrading to 9.1.0. However, an innovation track does have the occasional point release.

  4. Download the distribution that you want to install.

    For instructions, see Section 2.3, “How to Get MySQL”. To verify the integrity of the distribution, use the instructions in Section 2.4, “Verifying Package Integrity Using MD5 Checksums or GnuPG”.

  5. Install the distribution.

    To install MySQL from a binary distribution, use the instructions in Chapter 3, Installing MySQL on Unix/Linux Using Generic Binaries. Alternatively, use the Secure Deployment Guide, which provides procedures for deploying a generic binary distribution of MySQL Enterprise Edition Server with features for managing the security of your MySQL installation.

    To install MySQL from a source distribution or from the current development source tree, use the instructions in Chapter 4, Installing MySQL from Source.

  6. Perform any necessary postinstallation setup.

    After installing MySQL, see Chapter 9, Postinstallation Setup and Testing for information about making sure the MySQL server is working properly. Also refer to the information provided in Section 9.4, “Securing the Initial MySQL Account”. This section describes how to secure the initial MySQL root user account, which has no password until you assign one. The section applies whether you install MySQL using a binary or source distribution.

  7. If you want to run the MySQL benchmark scripts, Perl support for MySQL must be available. See Chapter 13, Perl Installation Notes.

Instructions for installing MySQL on different platforms and environments is available on a platform by platform basis: