For AI agents: the complete documentation index is available at https://www.jumpserver.com/docs/v4/llms.txt, the full documentation bundle is available at https://www.jumpserver.com/docs/v4/llms-full.txt, and this page is available as Markdown at https://www.jumpserver.com/docs/v4/installation.md.
🎉 JumpServer v4.10.20 is available. See what's new →
  • v4

    • Installation

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

    Try JumpServer Enterprise Edition free for 14 days

    No credit card required. Includes custom RBAC, enterprise SSO, multi-tenancy, and SLA-backed support.

    Request free trialContact sales

    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.

    Web
    wget
    1

    Log in to https://support.fit2cloud.com using the username and password provided by the support team.

    2

    View the details of your valid Enterprise Edition subscription and navigate to the 'Installation Packages' tab. Find the installation package that matches your required version and architecture, click the 'Download' button, and then click 'Download' in the pop-up dialog to copy the download link.

    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.10.20-x86_64.tar.gz
    6

    Change to the extracted directory.

    cd jumpserver-ee-v4.10.20-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