Red Hat Summit Red Hat SummitSupportConsoleDevelopersStart a trialContact

Chapter 3. Getting your node ID

When providing information to Red Hat Support, it is helpful to provide the unique identifier of your node. For MicroShift, you can get your node ID manually by using the OpenShift CLI (oc) or by retrieving the ID from a file.

Note

A node ID is created only after the MicroShift service runs for the first time after installation.

3.1. Getting the node ID of a running node
Copy link

Retrieving the node ID enables you to uniquely identify a device within your deployment. The node ID is required to register the node with central management systems, analyze system logs and alerts, and ensure that configuration updates are targeted accurately.

Procedure

  • Get the ID of a running node using oc get by entering the following command: 

    $ oc get namespaces kube-system -o jsonpath={.metadata.uid}
    Copy to Clipboard Toggle word wrap

    Example output

    7cf13853-68f4-454e-8f5c-1af748cbfb1a
    Copy to Clipboard Toggle word wrap

  • Get the ID of a running node by retrieving it from the cluster-id file by entering the following command: 

    $ sudo cat /var/lib/microshift/cluster-id
    Copy to Clipboard Toggle word wrap

    Example output

    7cf13853-68f4-454e-8f5c-1af748cbfb1a
    Copy to Clipboard Toggle word wrap

3.2. Getting the node ID of a stopped node
Copy link

When the MicroShift service is inactive, you can prevent the use of standard API commands by retrieving the node ID from the file system. You can use this ID to identify offline nodes for disaster recovery, verify backup compatibility, and troubleshoot issues.

Procedure

  • Get the ID of a stopped node by retrieving it from the cluster-id file by entering the following command: 

    $ sudo cat /var/lib/microshift/cluster-id
    Copy to Clipboard Toggle word wrap

    Example output

    7cf13853-68f4-454e-8f5c-1af748cbfb1a
    Copy to Clipboard Toggle word wrap

Red Hat logoGithubredditYoutubeTwitter

Learn

Try, buy, & sell

Communities

About Red Hat Documentation

We help Red Hat users innovate and achieve their goals with our products and services with content they can trust. Explore our recent updates.

Making open source more inclusive

Red Hat is committed to replacing problematic language in our code, documentation, and web properties. For more details, see the Red Hat Blog.

About Red Hat

We deliver hardened solutions that make it easier for enterprises to work across platforms and environments, from the core datacenter to the network edge.

Theme

© 2026 Red HatBack to top