URL does not contain a scheme – How to solve this Elasticsearch error

Opster Team

July-20, Version: 1.7-8.0

Before you begin reading this guide, we recommend you try running the Elasticsearch Error Check-Up which analyzes 2 JSON files to detect many configuration errors.

Briefly, this error message indicates that the URL provided to Elasticsearch is missing the protocol scheme (e.g., http, https). A URL (Uniform Resource Locator) is used to identify a web resource and provide a way to access it. To resolve this issue, you should ensure that the URL you are using includes the correct protocol scheme (e.g., http or https).

To easily locate the root cause and resolve this issue try AutoOps for Elasticsearch & OpenSearch. It diagnoses problems by analyzing hundreds of metrics collected by a lightweight agent and offers guidance for resolving them.

This guide will help you check for common problems that cause the log ” URL does not contain a scheme ” to appear. To understand the issues related to this log, read the explanation below about the following Elasticsearch concepts: plugin.

Log Context

Log “URL [{}] does not contain a scheme”classname  is HttpRequestTemplate.java We extracted the following from Elasticsearch source code for those seeking an in-depth context :

 try {
 URI uri = new URI(supposedUrl);
 if (Strings.hasLength(uri.getScheme()) == false) {
 throw new ElasticsearchParseException("URL [{}] does not contain a scheme"; uri);
 scheme = Scheme.parse(uri.getScheme());
 port = uri.getPort() > 0 ? uri.getPort() : scheme.defaultPort();
 host = uri.getHost();
 if (Strings.hasLength(uri.getPath())) {


Watch product tour

Try AutoOps to find & fix Elasticsearch problems

Analyze Your Cluster
Skip to content