XAMPP MySQL not starting on Windows

XAMPP MySQL not starting on Windows

XAMPP is a great tool for web developers who need to host websites locally on their own computers. Unfortunately, because it uses ports and services that are commonly used by other applications, conflicts can happen, causing certain applications on XAMPP to be unable to run.

In this article, we will be exploring what you can do if XAMPP’s Apache service does not run on Windows.

Note that if you are using XAMPP on macOS, please refer to the following article instead.

If you prefer to watch a video as opposed to reading, we have a YouTube video as well:

  1. Identifying the problem
  2. Possible causes and fixes
    1. Port 3306 is already used by another process
    2. Changing the port used by XAMPP
    3. MySQL’s data has been corrupted
  3. Unable to access phpMyAdmin
  4. Conclusion

1. Identifying the problem

Most of the time, when MySQL is unable to start, you will get an error message that looks something like this on the XAMPP Control Panel:

MySQL fails to start on XAMPP
MySQL failing to start on XAMPP.

Which isn’t very helpful, because it basically says that anything could be causing the issue.

[mysql] Attempting to start MySQL service...
[mysql] Status change detected: running
[mysql] Status change detected: stopped
[mysql] Error: MySQL shutdown unexpectedly
[mysql] This may be due to a blocked port, missing dependencies,
[mysql] improper priviliges, a crash, or a shutdown by another method.

In such a case, you will want to refer to XAMPP’s MySQL error log, which can be found under Logs > mysql_error.log.

XAMPP Control Panel mysql_error.log
Where to find the XAMPP MySQL error log.

Scroll all the way down to the bottom of the log file, and you should find a couple of lines that roughly explain why the MySQL service stopped. This can sometimes help to pinpoint you to the source of the issue.


Article continues after the advertisement:


2. Possible causes and fixes

If you’ve managed to pinpoint source of the issue on the mysql_error.log, you can scroll down to see if you are able to find a fix that vaguely resembles the issue you have.

Otherwise, we have ordered the fixes in the order that most people run into, so you can read them in the order that we present.

a. Port 3306 is used by another process

The most likely reason that XAMPP’s MySQL service is unable to start is because port 3306 is already used by a different program that is currently running on your computer. By default, XAMPP’s MySQL service binds to port 3306 when started, and it can only do so if another program is not already using it.

To ascertain whether this is the case, you can click on the Netstat button to open up a window with a list of all the ports that are being used on your computer currently. If port 3306 is in the list when you haven’t started MySQL on XAMPP, this means that another program is using it.

XAMPP's Netstat window
Use the Netstat window to check if port 3306 has already been occupied.

To remedy this, you will need to find the process that is using port 3306 and end the process. In the example above, a process called mysqld.exe is using port 3306. To stop it, I will have to use Ctrl + Alt + Delete to open up the Task Manager, then find and end the mysqld.exe process.

Task Manager
If your Task Manager doesn’t show all the processes, click on More details at the bottom of the window to get the full Task Manager window.

Once this is done, you can try starting MySQL on XAMPP again. Depending on the program that was occupying port 3306, this might or might not work. If it doesn’t work, you will have to find the program that was creating the process and uninstall it. In most cases, this should be another installation of MySQL on your computer, such as:

…or some other variation of MySQL, since it is one of the few programs that use port 3306.

After uninstalling the other program(s), you may need to restart your computer before trying to start MySQL again.

In some cases, it is still possible for XAMPP to successfully start even with port 3306 blocked. In such a case, XAMPP will start with an error message:

XAMPP MySQL starts with port 3306 occupied.
XAMPP MySQL starts with port 3306 occupied.

In such a case, however, you will not be able to:

  1. Access any website on XAMPP that needs a database connection, or;
  2. Access phpMyAdmin on XAMPP

To fix this, you simply need to find the program that XAMPP lists as being the culprit blocking port 3306 (see the first line of the error text in the image above).

b. Changing the port used by XAMPP MySQL

If you don’t want to uninstall the program that is using port 3306, or if you can’t find the process using the instructions above, you can also configure XAMPP MySQL to use a different port. Do note that if another MySQL program is using port 3306, there is a chance that this doesn’t work, as 2 seperate installations of MySQL can interfere with each other.

Regardless, below are the steps to change the port of XAMPP’s MySQL:

  1. In the XAMPP control panel, click on the Config button of the MySQL module.
  2. In the popped window, select my.ini.
Where to find MySQL's my.cnf
Where to find MySQL’s my.cnf.
  1. Inside the file, go down and find the section that contains the following line: # The MySQL server. Below this line, you should find the port number, which says port=3306 by default.
  2. Change to a different port. You can use any unused port on your computer between 1 to 65535, but I usually use port 3307.
  3. Save the changes to the file, and try to start MySQL on XAMPP again.

Article continues after the advertisement:


Below is a snapshot of my my.cnf file, with the part that you need to change highlighted:

my.cnf

# Example MySQL config file for small systems.
#
# This is for a system with little memory (<= 64M) where MySQL is only used
# from time to time and it's important that the mysqld daemon
# doesn't use much resources.
#
# You can copy this file to
# C:/xampp/mysql/bin/my.cnf to set global options,
# mysql-data-dir/my.cnf to set server-specific options (in this
# installation this directory is C:/xampp/mysql/data) or
# ~/.my.cnf to set user-specific options.
#
# In this file, you can use all long options that a program supports.
# If you want to know which options a program supports, run the program
# with the "--help" option.

# The following options will be passed to all MySQL clients
[client]
# password       = your_password 
port=3306
socket="C:/xampp/mysql/mysql.sock"


# Here follows entries for some specific programs 

# The MySQL server
default-character-set=utf8mb4
[mysqld]
port=33063307
socket="C:/xampp/mysql/mysql.sock"
basedir="C:/xampp/mysql"
tmpdir="C:/xampp/tmp"
datadir="C:/xampp/mysql/data"
pid_file="mysql.pid"
# enable-named-pipe
key_buffer=16M
max_allowed_packet=1M
sort_buffer_size=512K
net_buffer_length=8K
read_buffer_size=256K
read_rnd_buffer_size=512K
myisam_sort_buffer_size=8M
log_error="mysql_error.log"

# Change here for bind listening
# bind-address="127.0.0.1" 
# bind-address = ::1          # for ipv6

# Where do all the plugins live
plugin_dir="C:/xampp/mysql/lib/plugin/"

# Don't listen on a TCP/IP port at all. This can be a security enhancement,
# if all processes that need to connect to mysqld run on the same host.
# All interaction with mysqld must be made via Unix sockets or named pipes.
# Note that using this option without enabling named pipes on Windows
# (via the "enable-named-pipe" option) will render mysqld useless!
# 
# commented in by lampp security
#skip-networking
#skip-federated

# Replication Master Server (default)
# binary logging is required for replication
# log-bin deactivated by default since XAMPP 1.4.11
#log-bin=mysql-bin

# required unique id between 1 and 2^32 - 1
# defaults to 1 if master-host is not set
# but will not function as a master if omitted
server-id	=1

# Replication Slave (comment out master section to use this)
#
# To configure this host as a replication slave, you can choose between
# two methods :
#
# 1) Use the CHANGE MASTER TO command (fully described in our manual) -
#    the syntax is:
#
#    CHANGE MASTER TO MASTER_HOST=<host>, MASTER_PORT=<port>,
#    MASTER_USER=<user>, MASTER_PASSWORD=<password> ;
#
#    where you replace <host>, <user>, <password> by quoted strings and
#    <port> by the master's port number (3306 by default).
#
#    Example:
#
#    CHANGE MASTER TO MASTER_HOST='125.564.12.1', MASTER_PORT=3306,
#    MASTER_USER='joe', MASTER_PASSWORD='secret';
#
# OR
#
# 2) Set the variables below. However, in case you choose this method, then
#    start replication for the first time (even unsuccessfully, for example
#    if you mistyped the password in master-password and the slave fails to
#    connect), the slave will create a master.info file, and any later
#    change in this file to the variables' values below will be ignored and
#    overridden by the content of the master.info file, unless you shutdown
#    the slave server, delete master.info and restart the slaver server.
#    For that reason, you may want to leave the lines below untouched
#    (commented) and instead use CHANGE MASTER TO (see above)
#
# required unique id between 2 and 2^32 - 1
# (and different from the master)
# defaults to 2 if master-host is set
# but will not function as a slave if omitted
#server-id       = 2
#
# The replication master for this slave - required
#master-host     =   <hostname>
#
# The username the slave will use for authentication when connecting
# to the master - required
#master-user     =   <username>
#
# The password the slave will authenticate with when connecting to
# the master - required
#master-password =   <password>
#
# The port the master is listening on.
# optional - defaults to 3306
#master-port     =  <port>
#
# binary logging - not required for slaves, but recommended
#log-bin=mysql-bin


# Point the following paths to different dedicated disks
#tmpdir = "C:/xampp/tmp"
#log-update = /path-to-dedicated-directory/hostname

# Uncomment the following if you are using BDB tables
#bdb_cache_size = 4M
#bdb_max_lock = 10000

# Comment the following if you are using InnoDB tables
#skip-innodb
innodb_data_home_dir="C:/xampp/mysql/data"
innodb_data_file_path=ibdata1:10M:autoextend
innodb_log_group_home_dir="C:/xampp/mysql/data"
#innodb_log_arch_dir = "C:/xampp/mysql/data"
## You can set .._buffer_pool_size up to 50 - 80 %
## of RAM but beware of setting memory usage too high
innodb_buffer_pool_size=16M
## Set .._log_file_size to 25 % of buffer pool size
innodb_log_file_size=5M
innodb_log_buffer_size=8M
innodb_flush_log_at_trx_commit=1
innodb_lock_wait_timeout=50

## UTF 8 Settings
#init-connect=\'SET NAMES utf8\'
#collation_server=utf8_unicode_ci
#character_set_server=utf8
#skip-character-set-client-handshake
#character_sets-dir="C:/xampp/mysql/share/charsets"
sql_mode=NO_ZERO_IN_DATE,NO_ZERO_DATE,NO_ENGINE_SUBSTITUTION
log_bin_trust_function_creators=1

character-set-server=utf8mb4
collation-server=utf8mb4_general_ci
[mysqldump]
max_allowed_packet=16M

[mysql]
# Remove the next comment character if you are not familiar with SQL
#safe-updates

[isamchk]
key_buffer=20M
sort_buffer_size=20M
read_buffer=2M
write_buffer=2M

[myisamchk]
key_buffer=20M
sort_buffer_size=20M
read_buffer=2M
write_buffer=2M

[mysqlhotcopy]

c. MySQL’s data has been corrupted

If you have had multiple copies of MySQL installed on your device at one point, or had a separate installation of XAMPP, it is possible that the data in your current installation might have been corrupted. In such a scenario, you can try:

  1. Ensuring that all other installations of MySQL are removed on your computer, then uninstalling and reinstalling XAMPP, or;
  2. Restoring your existing XAMPP’s MySQL installation with backup data.

If you would like to try option B before reinstalling XAMPP, you can follow the steps below:

  1. Go to your XAMPP MySQL directory. By default, it is located under Local Disk → XAMPP → MySQL (e.g. if you installed it under the default C-drive, you will find the folder in C:\xampp\mysql). Here you will be seeing different folders — the ones that we need to use are the data and backup folders
  2. Rename the data folder to data_old.
  3. Create a new folder with the name data. This is the new folder that MySQL will use to replace the old one. Now, we need to fill this folder with certain files.
  4. Go to the backup folder and copy all the files inside it. Paste them into the new data folder.
  5. Now, we need to paste databases into our new data folder. In order to do so, inside the data_old folder, copy the mySQL folder, as well as all the folders under the phpmyadmin folder. If you have only one folder, it is totally okay, just make sure you paste it. There is NO need to copy the performance_schema and phpmyadmin folders.
  6. Last but not least, we need to copy the ibdata1 file. Go to your data_old folder, find the ibdata1 file, and past it into the data folder.

Are the above steps above confusing to read? Click here to watch the part of our video that demonstrates the steps above.

3. Unable to access phpMyAdmin

There can also be cases where you are able to start MySQL on XAMPP, but are unable to access the http://localhost/phpmyadmin URL. This can be caused by a multitude of reasons, and we explore this in a separate article:

4. Conclusion

As with the other articles on the blog, we’d love if you leave a comment below, especially if you:

  1. Find any errors in this article.
  2. Find a problem causing this issue that is not described in this article.

We will periodically upload this article with new solutions and issues that we find, and we will credit you if you share your issues and / or solutions! Your comments will add to the information that is already here, and help other future readers!


Article continues after the advertisement:


There are 7 comments:

  1. thank you soo much it worked the 2nd option the corrupted data was my issue
    but am glad it is solved

Leave a Reply

Your email address will not be published. Required fields are marked *

Note: You can use Markdown to format your comments.

This site uses Akismet to reduce spam. Learn how your comment data is processed.