how to solve error SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure

how to solve error SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure

July 31, 2026 · Illustrated author avatarBy Stefan Bogdanescu
how to solve error SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure

Solving SSL23_GET_SERVER_HELLO:sslv3 Alert Handshake Failure in Magento

Are you facing the “SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure” error while installing or running your Magento application? Don’t worry, we’ll walk through a step-by-step guide to resolve this issue.

Understanding the SSL Error

The SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure error typically occurs due to compatibility issues between your server and the client (your Magento instance). It happens when the server expects an older SSL protocol (like SSLv3) that is no longer supported.

Step 1: Identify Your PHP Version

The first step is to check which version of PHP you are currently using. You can do this by running php -v in your terminal or through your server’s control panel.

The error often arises with older versions of PHP where SSLv3 support is still enabled. If your PHP version is 5.x, it might be time for an upgrade to a more secure and compatible version like 7.x or 8.x.

Step 2: Disable SSLv3

If you have confirmed that your PHP version has SSLv3 support (which is typically the case in older versions), you need to disable it. Here’s how:

For Apache + mod_php

Open your Apache configuration file, usually located at /etc/apache2/apache2.conf or /etc/httpd/conf/httpd.conf.

Add or update the following line:

SSLProtocol All -SSLv3 -TLSv1

Save and reload the Apache server configuration.

For Nginx + php-fpm

Open your Nginx configuration file, typically at /etc/nginx/nginx.conf. Add or update the ssl_protocols directive under the http block:

http {
    ...
    ssl_protocols TLSv1.1 TLSv1.2;
    ...
}

Reload the Nginx configuration.

Step 3: Restart Your Web Server

After making these changes, restart your web server for the modifications to take effect:

For Apache:

sudo systemctl restart apache2

For Nginx:

sudo systemctl restart nginx

Step 4: Verify the Installation/Connection

Now that you’ve disabled SSLv3 and restarted your server, try installing or connecting to your Magento instance again.

If everything is set up correctly, the error should be resolved, and you should be able to proceed with your Magento installation or operations without any issues related to SSL handshake failures.

Best Practices for Magento Security

To ensure a secure and stable environment for your Magento store:

  • Keep your PHP version up-to-date.
  • Regularly apply security patches provided by Magento.
  • Use strong, unique passwords for all accounts.
  • Implement HTTPS for all communication (ensure you have an SSL certificate installed).
  • Consider using a Web Application Firewall (WAF) to protect against attacks.

Remember that maintaining the security and stability of your e-commerce platform requires continuous monitoring and regular maintenance. If you need professional assistance with Magento development or security, feel free to reach out to the experts at Laravel Company.

The SSL23_GET_SERVER_HELLO:sslv3 alert handshake failure error may seem intimidating, but by following these steps and adhering to best security practices, you can ensure a smooth operation for your Magento store.

Configuration Deployment Errors CLI

Our network