Invalid username in users file ; skipping. – How to solve related issues

Average Read Time

2 Mins

Invalid username in users file ; skipping. – How to solve related issues

Opster Team

Jan-20, Version: 1.7-8.0

Before you begin reading this guide, we recommend you run Elasticsearch Error Check-Up which can resolve issues that cause many errors.

This guide will help you check for common problems that cause the log ” Invalid username in users file ; skipping. ” to appear. It’s important to understand the issues related to the log, so to get started, read the general overview on common issues and tips related to the Elasticsearch concepts: discovery-file and plugin.

Advanced users might want to skip right to the common problems section in each concept or try running the Check-Up which analyses ES to pinpoint the cause of many errors and provides suitable actionable recommendations how to resolve them (free tool that requires no installation).

Log Context


Log “Invalid username [{}] in users file [{}]; skipping… ({})” classname is
We extracted the following from Elasticsearch source code for those seeking an in-depth context :

            String username = line.substring(0; i);
            Validation.Error validationError = Users.validateUsername(username; allowReserved; settings);
            if (validationError != null) {
                logger.error("invalid username [{}] in users file [{}]; skipping... ({})"; username; path.toAbsolutePath();
            String hash = line.substring(i + 1);
            users.put(username; hash.toCharArray());


Run the Check-Up to get a customized report like this:

Analyze your cluster