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, and this page is available as Markdown at https://www.jumpserver.com/docs/features/system-settings/appearance-tools/appearance.md.
🎉 JumpServer v5.1.1 is available. See what's new →
  • v5

    • Appearance

    Enterprise Edition

    Custom themes and logo replacement require JumpServer Enterprise Edition. Community Edition uses the default branding.

    Request 14-day free trial

    Appearance changes the visual identity of this JumpServer deployment. The settings are instance-wide: title, theme, logos, the login illustration, and footer content are the same for every organization and every user.

    Overview

    Every field on this page is optional. Empty fields keep the built-in value, and the Restore button returns the entire page to the default appearance.

    Customize the appearance

    1

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

    image
    2

    In the left menu, click Appearance.

    3

    Update the basic, logo, image, and footer settings described below.

    4

    Click Submit.

    5

    Reload the page to confirm the new title, logos, and login image.

    Figure 1: Appearance settings

    Field reference

    FieldDescription
    Login titleTitle shown on the login page and in the browser tab of the sign-in flow.
    ThemeColor theme of the console. Available themes are Classic green (default), Chinese red, Deep black, Noble purple, and Technology blue.
    Wide logo on topLogo shown in the upper-left corner of the console. Recommended size: 185 × 55 px.
    Small logo without textSquare icon shown in the web terminal. Recommended size: 82 × 82 px.
    Website iconBrowser tab icon (favicon). Recommended size: 16 × 16 px.
    Login imageIllustration shown to the right of the login form. Recommended size: 492 × 472 px.
    Footer contentMarkdown text displayed at the bottom of the login page, commonly used for the registration number or legal notice.

    Uploads accept JPG and PNG files. Images are stored by JumpServer and served from the same origin as the console, so no restart is required after saving.

    Figure 2: Theme selection

    Restore defaults

    1

    Open the Appearance page.

    2

    Click Restore at the bottom of the page.

    3

    Confirm the prompt. The default title, theme, logos, login image, and footer are restored immediately.

    Note

    The theme choice affects the whole console. Individual display preferences, such as language and layout, are stored per user and are configured from Preferences.