> For AI agents: the complete documentation index is available at https://www.jumpserver.com/docs/llms.txt, the full documentation bundle is available at https://www.jumpserver.com/docs/llms-full.txt.

# Quickstart

This end-to-end guide takes you from installation to your first authorized asset
session. It combines first login, Console orientation, asset setup, authorization,
connection, and audit into one flow.

You can watch the video below or follow the steps in order.


## Before you begin

You need:

- A running JumpServer installation. See [Installation](https://www.jumpserver.com/docs/installation.md).
- The URL of the deployment and the initial administrator account.
- A test asset (for example, a Linux host) that JumpServer can reach.

## Sign in and secure the account

1. Open `https://<jumpserver-host>/` in a current browser.
2. Sign in with the initial account: username `admin`, password `ChangeMe`.
3. Complete the forced password change and sign in again.


Warning

The default password is public. Change it immediately and do not reuse it for
other systems. If MFA is required by the platform policy, complete MFA setup
before continuing.

## Get oriented in Console

After login, the area switcher at the top-left moves between **Console**, **PAM**,
**Audits**, and **Workbench**. System administrators can open **System Settings**
from the gear icon.

Console is the administration workspace. Its left menu is organized as follows:

| Section  | Pages                     | Purpose                                                                  |
| -------- | ------------------------- | ------------------------------------------------------------------------ |
| Users    | Users, Groups             | Identity and group membership                                            |
| Assets   | Assets, Zones, Cloud Sync | Asset inventory and network zones                                        |
| Accounts | Accounts, Templates       | Privileged account inventory and templates                               |
| Policies | Authorizations, ACLs      | Grant access and constrain commands, connections, masking, and clipboard |
| Others   | Tags                      | Organize and filter resources                                            |

![Console dashboard after first login](/images/v5/jumpserver/v5_admin_dashboard_01.png)

The recommended setup order is: users and groups → assets → accounts →
authorizations → ACLs → verify access from Workbench. The steps below follow that
order for a single test asset.

## Create an asset


1

At the top-left of the page, select , then click  **Console**.

![image](/docs/images/docs/navs/nav-console.png)

2

Navigate to the **Console > Assets > Host** tab.

3

Click **Create** to open the platform selection page on the right.

4

Select the **Linux** platform and open the asset creation page.

5

In the **Name** field, type a name for the asset, such as "Demo Linux".

6

In the **IP/Host** field, type the IP address of the asset, such as "172.16.10.110".

7

In the **Linux** field, keep the "Linux" platform selected.

8

In the **Nodes** field, select the "/DEFAULT" node.

9

In the **Accounts** field, click the **Add** and follow the steps in the pop-up to complete the account creation.

1

In the **Name** field, type a name for the account, such as "root".

2

In the **Username** field, type the username for the account, such as "root".

3

In the **Secret type** field, select "Password".

4

In the **Password** field, type the password for the account.

5

For other fields, keep the default values.

6

click **Confirm**.

10

For other fields, keep the default values.

11

Click **Submit**.

## Authorize the asset


1

At the top-left of the page, select , then click  **Console**.

![image](/docs/images/docs/navs/nav-console.png)

2

Navigate to the **Console > Authorization** page.

3

Click <Icon name="plus" />**Create** to open the authorization creation form on the right-side page.

4

In the **Name** field, type a name for the authorization, such as "Authorize Demo Linux to Administrator".

5

In the **Users** field, select the "Administrator(admin)".

6

In the **Assets** field, select the "Demo Linux".

7

In the **Accounts** field, check only the box for "All existing accounts".

8

For other fields, keep the default values.

9

Click **Submit**.

## Connect to the asset via the web


1

In the right area of the top navigation bar, click .

![image](/docs/images/docs/navs/nav-web-terminal.png)

2

At this point, the Web Terminal page should be open in a new browser tab.
In the authorization tree on the left side, search for and click the "Demo Linux" asset.

3

An asset connection pop-up will appear, select connection parameters and establish the connection.

1

Select the "SSH" tab, under the "Connect - Demo Linux".

2

In the **Select account** section, Select "root".

3

In the **Connect method** section, Select "Web > Web CLI".

4

Click **CONNECT**.

4

By this time, you should have successfully connected to the asset.

5

Next, you can try executing commands such as `ls -al`, `whoami` or `pwd`, etc.

6

Finally, run `exit` to end the current session.

## Audit the session


1

At the top-left of the page, select , then click  **Audits**.

![image](/docs/images/docs/navs/nav-audits.png)

2

Navigate to the **Audits > Asset sessions > Historical sessions** tab.

3

You can view the history of asset connection sessions.

4

In the **Actions** column, click "Playback" to watch the recording online or "Download" to save it.

## Audit executed commands


1

At the top-left of the page, select , then click  **Audits**.

![image](/docs/images/docs/navs/nav-audits.png)

2

Navigate to the **Audits > Session commands** page.

3

You can view all executed commands.

4

Click <Icon name="chevron-down" /> at the end of the row to view the command result.

## Next steps

Now that you have completed the quickstart flow, continue with the module that
matches your work:

- [Console](https://www.jumpserver.com/docs/features/console/index.md) — users, assets, accounts, authorizations, and ACLs
- [PAM](https://www.jumpserver.com/docs/features/pam/index.md) — account automation and account security
- [Audits](https://www.jumpserver.com/docs/features/audits/index.md) — sessions, logs, jobs, tickets, and reports
- [Workbench](https://www.jumpserver.com/docs/features/workbench/index.md) — daily access, file transfer, and jobs
- [Client](https://www.jumpserver.com/docs/features/client/index.md) — Luna and native connection methods
- [Role Guides](https://www.jumpserver.com/docs/roles/index.md) — what each role can do