Initial Login

The default Heimdall server username is “admin” and the password is:

“heimdall”.

In AWS, Azure and GCP and similar environments (such as OpenStack), the Cloud instance ID is the default password.

If the password is not set to “heimdall” please see the server log (/var/log/heimdallserver.out.log or /opt/heimdall/log/heimdall.log) and look for a line such as:

2016-12-11 20:10:32,516 5153 [INFO] [http-nio-8087-exec-1] Initializing access control, user=admin, 
password=i-0aa1234a1a1a12abc

Note: It doesn't matter what install method you use--if in a cloud provider, as long as the software can detect the instance ID, it will default to the instance ID for the password. The following sources will be used to attempt to detect a cloud instance ID:

  • http://169.254.169.254/latest/meta-data/instance-id (aws & compatible environments)
  • http://169.254.169.254/metadata/instance/compute/subscriptionId?api-version=2020-09-01&format=text (Azure)
  • http://169.254.169.254/computeMetadata/v1/instance/id (GCP)

Note: As Azure doesn't expose the vmID to users easily, the subscription ID is used instead

User Reset

The default username and password for a server can be controlled explicitly by creating a file /etc/heimdall.conf prior to the server being first run, and add the lines:

  • hduser={username}
  • hdpassword={password}

For more details of a file /etc/heimdall.conf, please see heimdall.conf configuration.

When the http query “http://169.254.169.254/latest/meta-data/instance-id” returns a value, this value is used as the default password if no configuration is set in the /etc/heimdall.conf. This will happen in AWS instances, and some other cloud environments. This value can be obtained with:

echo `curl -s http://169.254.169.254/latest/meta-data/instance-id`

In the event the passwords need to be deleted from a current configuration, the following steps can be used to delete the configured accounts:

  1. Open the file $heimdallhome/config/heimdall.conf (the default install directory is /opt/heimdall/) in an editor (notepad, vi, etc)
  2. Remove the json array values for the “address” variable, i.e. replace:

    “addresses”:[{“enabled”:true,”file”:”config/admin_1.conf”,”name”:”admin”,”version”:1}]

With

“addresses”:[]

Once saved, if all accounts are removed, then the default admin account will be re-initialized once the Heimdall server is restarted.