Docs
Installation

Installation guide for JumpServer

This topic describes how to install JumpServer, including both the open-source and enterprise editions.

Experience the full features of the JumpServer enterprise edition with a 14-day free trial — Contact us today to get started and explore all the benefits!

Install with a one-line command

This section introduces how to install the open-source version of JumpServer using a one-line command.

1

Prepare a clean Linux server ( 64bit, >= 4c8g ).

2

Log in to the Linux server using the "root" or another user with superuser privileges.

3

Change to the /opt directory.

4

Run the command to install the latest open-source version of JumpServer.

curl -sSL https://github.com/jumpserver/jumpserver/releases/latest/download/quick_start.sh | bash
5

After the installation is complete, open your Chrome browser and enter "http://<your-server-ip>" in the address bar.

Note

Replace <your-server-ip> with your actual server IP address.

6

Log in as an Administrator using the following default credentials.

  • username: admin
  • password: ChangeMe
7

For security, you will be prompted to change your password after logging in. Once you've changed it and logged in again, you can start your JumpServer journey.

8

At this point, you have successfully installed JumpServer.

Install with an offline package

This section describes how to install the Enterprise Edition of JumpServer using an offline package.

1

Prepare a clean Linux server ( 64bit, >= 4c8g ).

2

Log in to the Linux server using the "root" or another user with superuser privileges.

3

Change to the /opt directory.

4

Download the JumpServer Enterprise offline installation package.

1

Log in to https://download-pkgs.jumpserver.com (opens in a new tab) using the username and password provided by the support team.

2

Click filename to download the offline installation package for the required version.

3

Upload the offline installation package to the /opt directory on the deployment server.

5

Extract the offline installation package.

tar -zxvf jumpserver-ee-v4.9.0-x86_64.tar.gz
6

Change to the extracted directory.

cd jumpserver-ee-v4.9.0-x86_64
7

Perform the installation, the installation process can be completed using all default options. After the installation is complete, you can adjust the settings by modifying the configuration files.

./jmsctl.sh install
8

After the installation is complete, running docker ps will show the following three containers running:

  • jms_core
  • jms_postgresql
  • jms_redis
9

Start all services.

./jmsctl.sh start
10

Open your Chrome browser, enter "http://<your-server-ip>" in the address bar.

Note

Replace <your-server-ip> with your actual server IP address.

11

Log in as an Administrator using the following default credentials.

  • username: admin
  • password: ChangeMe
12

For security, you will be prompted to change your password after logging in. Once you've changed it and logged in again, you can start your JumpServer journey.

13

At this point, you have successfully installed JumpServer.

Next steps

QuickstartUpgrade