Failed to start initial join process – How to solve this Elasticsearch error

Opster Team

Aug-23, Version: 2.3-2.3

Briefly, this error occurs when an Elasticsearch node fails to join a cluster during the initial startup process. This could be due to network connectivity issues, incorrect configuration settings, or firewall restrictions. To resolve this issue, you can check the network connectivity between the nodes, ensure that the cluster name is correctly configured in the elasticsearch.yml file, and verify that there are no firewall rules blocking the communication. Additionally, check the discovery settings and make sure that the correct IP addresses and ports are specified for the nodes in the cluster.

This guide will help you check for common problems that cause the log ” failed to start initial join process ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: discovery and join.

Log Context

Log “failed to start initial join process” classname is
We extracted the following from Elasticsearch source code for those seeking an in-depth context :

                 return currentState;

            public void onFailure(String source; 
org.elasticsearch.common.Nullable Throwable t) {
                logger.warn("failed to start initial join process"; t);



How helpful was this guide?

We are sorry that this post was not useful for you!

Let us improve this post!

Tell us how we can improve this post?