# Initial run guide

## Overview

This page provides all the information you need to install and run StackState.

## Installation instructions

{% tabs %}
{% tab title="Kubernetes" %}
Install StackState on [Kubernetes](/5.1/setup/install-stackstate/kubernetes_openshift.md).
{% endtab %}

{% tab title="Linux" %}
Install StackState on [Linux](/5.1/setup/install-stackstate/linux.md).
{% endtab %}

{% tab title="OpenShift" %}
Install StackState on [OpenShift](/5.1/setup/install-stackstate/kubernetes_openshift/openshift_install.md).
{% endtab %}
{% endtabs %}

## Address and port

{% tabs %}
{% tab title="Kubernetes" %}
To access the StackState UI:

1. [Enable a port-forward](/5.1/setup/install-stackstate/kubernetes_openshift/kubernetes_install.md#access-the-stackstate-ui).
2. Access the StackState UI at: <https://localhost:8080>
   {% endtab %}

{% tab title="Linux" %}
The StackState UI can be accessed using the `<STACKSTATE_BASE_URL>` specified during installation:

`https://<STACKSTATE_BASE_URL>:7070`
{% endtab %}

{% tab title="OpenShift" %}
To access the StackState UI:

1. [Enable a port-forward](/5.1/setup/install-stackstate/kubernetes_openshift/openshift_install.md#access-the-stackstate-ui).
2. Access the StackState UI at: <https://localhost:8080>
   {% endtab %}
   {% endtabs %}

## Default username and password

{% tabs %}
{% tab title="Kubernetes" %}
StackState is configured by default with the following administrator account:

* **username:** `admin`
* **password:** Set during installation. This is collected by the `generate_values.sh` script and stored in MD5 hash format in `values.yaml`
  {% endtab %}

{% tab title="Linux" %}
StackState is configured by default with the following administrator account:

* **username:** `admin`
* **password:** `topology-telemetry-time`
  {% endtab %}

{% tab title="OpenShift" %}
StackState is configured by default with the following administrator account:

* **username:** `admin`
* **password:** Set during installation. This is collected by the `generate_values.sh` script and stored in MD5 hash format in `values.yaml`
  {% endtab %}
  {% endtabs %}

## Troubleshooting

If you run into any problems during the installation of StackState or first run, check the [StackState installation troubleshooting guide](/5.1/setup/install-stackstate/troubleshooting.md).

## Next steps

Once you have StackState up and running, you can get started setting up integrations

* [Install StackPacks to integrate with external systems](/5.1/stackpacks/about-stackpacks.md)
* [Explore your topology and get to know the StackState UI](/5.1/use/stackstate-ui/explore_mode.md)
* [Identify problems in the topology](/5.1/use/problem-analysis/about-problems.md)


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://archivedocs.stackstate.com/5.1/setup/install-stackstate/initial_run_guide.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.