Webmin "Error code ssl_error_rx_record_too_long" - Fix it Now ?

Webmin "Error code ssl_error_rx_record_too_long"  occurs while trying to log into a newly installed Webmin. This issue indicates that SSL module is not yet active.

Here at Ibmi Media, as part of our Server Management Services, we regularly help our Customers to perform related Webmin queries.

How to fix "Error code ssl_error_rx_record_too_long" in Webmin ?

The error can happen if we do not configure SSL for Webmin and enable it.

Before going into the steps for fixing this error we will see what causes this error.

A typical error looks like the one given below:

An error occurred during a connection to xxx.xxx.xxx.xxx:10000.
SSL received a record that exceeded the maximum permissible length.
(Error code: ssl_error_rx_record_too_long)

How to fix "Error code ssl_error_rx_record_too_long" ?

To fix this error, we need to Connect to the URL with http and not https.

1. Install SSL

Following are the steps to install SSL for Webmin:

  • Log in to Webmin and enable/install SSL.
  • Then need to download our certificate and CA bundle from the certificate authority.
  • After downloading it we need to upload the above-mentioned files to Webmin.
  • And click Others, then Upload and Download.
  • After that, choose the Upload to server tab in the main window, then select the files to upload.
  • Then specify the path to store them, and click Upload.

2.  Configure Apache using Webmin

Follow the steps for configuring Apache using Webmin:

  • First, click the Apache Webserver entry in the Servers menu and choose the Global configuration tab.
  • Then press the Configure Apache Modules icon.
  • From the list of Apache modules, find the SSL entry, check the box and press the Enable Selected Modules button.
  • After a few seconds, we will be prompted to the Apache Webserver’s main page. We have to choose the Create virtual host tab there.
  • We have to specify port 443 after putting the radio button near the blank field in the Port section, enter the path to the document root folder in Document Root.
  • And type in the domain name in the Server Name section.
  • Then press the Create Now button to add a new virtual host.
  • In the newly opened Existing virtual hosts tab, we must click on the globe button next to the virtual host that we have just created.
  • After that, find and click on the SSL Options icon in Virtual Server Options.

3. Adjust SSL options

We can adjust the SSL options in the following way:

  • Enable SSL ? – select Yes.
  • SSL protocols – make sure to uncheck SSLv2 and SSLv3 as these protocols are considered to be unsecure.
  • Certificate/private key file – the path to the uploaded example_com.crt file Private key file – the path to the private key file that was initially generated with the CSR code; used for the certificate activation.
  • Certificate authorities file – the path to the uploaded example_com.ca-bundle file.
  • Press the Save button to update the SSL settings.
  • In order to apply all of the changes we have made so far, we need to restart Apache.
  • To open the needed page, we can press the Bootup and Shutdown entry under the System menu.
  • From there we can find the apache2 service, and check the corresponding checkbox on the left.
  • After that, scroll down to the bottom and press the Restart button.

4. Enable SSL

For enabling SSL we can use the following steps:

  • Log in to the Webmin dashboard.
  • After that select Webmin, then Webmin Configuration.
  • Then we have to select SSL Encryption.
  • Now, toggle Enable SSL?
  • Finally click Save and Refresh Webmin then log back into Webmin.

[Still facing Virtualmin errors ? We can help you. ]


This article covers how to troubleshoot "Error code ssl_error_rx_record_too_long" in Webmin. Usually the ssl_error_rx_record_too_long error means that the service is not speaking in SSL - for example, if you try to access an http-only service via https. 

Are you sure that webmin is set up to talk in ssl on port :10000?