> 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.

# Installation

JumpServer has two installation paths. Choose the one that matches your edition
and network environment.

| Edition            | Installation method          | Use when                                                                          |
| ------------------ | ---------------------------- | --------------------------------------------------------------------------------- |
| Community Edition  | Online one-line command      | The server has outbound internet access and you want the latest community release |
| Enterprise Edition | Offline installation package | You have an Enterprise license and deploy in a restricted or air-gapped network   |


Note

Both editions require a clean 64-bit Linux server with at least 4 CPU cores and
8 GB of memory. Use a host that you can dedicate to JumpServer; do not reuse a
server that already runs conflicting web or database services.


JumpServer Enterprise Edition

Custom RBAC, multi-tenant organizations, enterprise SSO, and SLA-backed support. 14-day free trial, no credit card required.

[Start 14-day free trial](https://www.jumpserver.com/free-trial)[Contact sales](https://www.jumpserver.com/contact)[Compare editions](/docs/reference/compare-editions)

## Before you begin

- Prepare a clean Linux server (64-bit, at least 4c8g).
- Sign in as `root` or a user with superuser privileges.
- Confirm the server can reach its package source:
  - Community Edition: outbound HTTPS access to GitHub.
  - Enterprise Edition: the offline package from your delivery team.
- Decide the host name or IP address that users will use to access JumpServer.

## Community Edition: online installation

The Community Edition is installed with a one-line command that downloads and
runs the current installer. Use this path when the server has internet access.


1

Change to the `/opt` directory.
```sh
cd /opt
```

2

Run the online installation command.
```sh
curl -sSL https://github.com/jumpserver/jumpserver/releases/latest/download/quick_start.sh | bash
```

3

Wait for the installer to finish. It downloads the required images and starts the
JumpServer services.

4

Open `https://<jumpserver-host>/` in a current browser.

Note

Replace `<jumpserver-host>` with the IP address or domain name of the server.

5

Sign in with the initial administrator account:
- Username: `admin`
- Password: `ChangeMe`

6

Change the password when prompted, then sign in again. Installation is complete.

## Enterprise Edition: offline package installation

The Enterprise Edition is installed from an offline package provided by the
JumpServer delivery team. The package contains the images and dependencies needed
for a deployment without internet access. An Enterprise license is required.


1

Obtain the Enterprise offline package and license from your delivery team. Confirm
that the package version and CPU architecture match the target server.

2

Sign in as `root`, then change to `/opt`.
```sh
cd /opt
```

3

Place the offline package in `/opt`. You can upload it from the delivery portal or
download it with `wget` if the server can reach the download URL.

**Upload**

1

Download the package from the offline package site provided by the delivery
team.

2

Upload the package to `/opt` on the deployment server.


**wget**

1

Copy the package download link from the delivery portal.

2

Replace `YOUR_DOWNLOAD_URL` with the copied link and download the package.

```sh
cd /opt && wget -O jumpserver-ee-v5.1.1-x86_64.tar.gz "YOUR_DOWNLOAD_URL"
```

4

Extract the package.

```sh
tar -zxvf jumpserver-ee-v5.1.1-x86_64.tar.gz
```

5

Change to the extracted directory.

```sh
cd jumpserver-ee-v5.1.1-x86_64
```

6

Run the installer. The default options are sufficient for a standard deployment;
you can adjust the configuration files afterward.
```sh
./jmsctl.sh install
```

7

Start the services.
```sh
./jmsctl.sh start
```

8

Confirm that the services are running and healthy.
```sh
./jmsctl status
```
The core services include `jms_core`, `jms_postgresql`, and `jms_redis`.

9

Open `https://<jumpserver-host>/` in a current browser.

Note

Replace `<jumpserver-host>` with the IP address or domain name of the server.

10

Sign in with the initial administrator account:
- Username: `admin`
- Password: `ChangeMe`

11

Change the password when prompted, then import the Enterprise license. See
[License](https://www.jumpserver.com/docs/reference/license.md).

## Next steps

- [Quickstart](https://www.jumpserver.com/docs/quickstart.md): sign in, open the Console, and complete your first asset connection.
- [Import License](https://www.jumpserver.com/docs/reference/license.md): activate Enterprise Edition features.
- [Enable HTTPS](https://www.jumpserver.com/docs/operations/enable-https.md): secure the web interface.
- [Upgrade JumpServer](https://www.jumpserver.com/docs/upgrade.md): plan the next version upgrade.