Skip to main content
Code42 Support

Customizing Your Administration Console

Available in:

  • CrashPlan PRO
    • Standard
    • Premium
    • Enterprise
Applies to:

Overview

You can customize these elements of the administration console:

  • Administration console images
  • Administration console labels
  • Button colors on the sign-in screen
  • Account recovery links on the sign-in screen

This tutorial describes how to make these customizations.

Considerations

  • Custom labels and buttons are not automatically preserved when a server upgrades from 5.3.x or earlier.
  • If you use managed appliances, you cannot perform most of these customizations because they require access to your Code42 server's file system. If you use managed appliances, contact your PRO Services representative.
  • Customizing administration console images can be performed by all users with access to the administration console because that process uses the Code42 API.

Customize administration console images

The administration console supports customization of two images:

  • The sign-in screen logo
  • The administration console header

You must use the Code42 API to customize images in your administration console.

Before you begin

Step 1: Prepare your custom images

Your custom images must meet the requirements provided below for file name, file format, and image dimensions.

Image Supported Filenames Supported Formats Supported Vertical Size Supported Horizontal Size
Sign-in screen logo logo-login.png PNG Up to 36 px Up to 160 px
Header logo

logo-header.png

PNG Up to 36 px Any

Step 2: Send your images to your Code42 server with the Code42 API

To send your images to your Code42 server, use the customAsset resource of the Code42 API to send one or both images.

Further uses of customasset
For more information on using this API resource, review the customAsset resource's API documentation using the Code42 API Documentation Viewer.

In the following examples, replace the following items with information appropriate for your Code42 environment:

  • username
  • password
  • https://master-server.example.com:4285

Examples with curl

  • Sending the sign-in screen logo:
    curl -skvu 'username:password' -X PUT -F "customAsset=@logo-login.png" https://master-server.example.com:4285/api/CustomAsset/logo-login.png?type=image
    
  • Sending the header logo:
    curl -skvu 'username:password' -X PUT -F "customAsset=@logo-header.png" https://master-server.example.com:4285/api/CustomAsset/logo-header.png?type=image
    
  • Excerpt from a successful API request:
    > PUT /api/customAsset/logo-login.png HTTP/1.1
    ...
    < HTTP/1.1 200 OK
    ...
    {"metadata":{"timestamp":"2016-01-28T15:14:00.708-06:00","params":{}},"data":{"file":"logo-login.png","isCustom":true}}
    

Customize administration console labels

On your Code42 server's file system, navigate to, or create, the custom folder:

    • Linux: /opt/proserver/content-custom/Default-custom/shared/custom
    • Windows: C:\Program Files\CrashPlan PROe Server\content-custom\Default-custom\shared\custom
    • OS X: /Applications/PROServer.app/Contents/Resources/Java/content-custom/Default-custom/shared/custom
  1. Open or create the file properties.json.
  2. Add name/value pairs for each text string you want to customize.
    A list of supported names and values is provided below.
  3. Save your changes to the file.
  4. Clear your browser's cache, and open the administration console to view your changes.
Upgrading from Code42 server version 5.3 or earlier
When upgrading from Code42 server version 5.3 or earlier, manually copy customization from the old customization file to the new one.

Available localizations

JSON File Language Locale Name
txt.json English (US) English (United States)
txt_ca.json Deprecated - this file is not applied.
txt_da.json Deprecated - this file is not applied.
txt_de_CH.json Deprecated - this file is not applied.
txt_de.json German Deutsch
txt_en_GB.json English (GB) English (United Kingdom)
txt_en.json Deprecated - this file is not applied.
txt_es_ES.json Spanish (Spain) Español (España)
txt_es.json Deprecated - this file is not applied.
txt_es_LA.json Spanish (Latin America) Español (América Latina)
txt_fi.json Deprecated - this file is not applied.
txt_fr.json French Français
txt_hu.json Deprecated - this file is not applied.
txt_it.json Italian Italiano
txt_ja.json Japanese ?????????
txt_ko.json Korean ?????????
txt_nl.json Dutch Nederlands
txt_no.json Norwegian Norsk bokmål
txt_pl.json Deprecated - this file is not applied.
txt_pt_BR.json Portuguese (Brazil) Português (Brasil)
txt_pt.json Deprecated - this file is not applied.
txt_sv.json Swedish Svenska
txt_th.json Thai ?????????
txt_tr.json Deprecated - this file is not applied.
txt_zh.json Chinese (Simplified) ??????
txt_zh_TW.json Chinese (Traditional) ?????? - ??????

Supported names and values

You can configure these name/value pairs:

Name Description Original Value
  login_logo_text Additional text shown above the logo on the sign-in screen. No text is displayed by default.
  _placeholder_password Sign-in screen label for the password field Password
  _placeholder_username_or_email Sign-in screen label for the username field Username or email
  _validate_password_required Alert text when password left empty Password is required
  _validate_username_or_email Alert text when username/email left empty Username or email is required

Customize sign-in screen button colors

You can customize the colors of buttons on your administration console's sign-in screen using custom CSS specifications.

  1. On your Code42 server's file system, navigate to or create the custom folder:
    • Linux: /opt/proserver/content-custom/Default-custom/shared/custom
    • Windows: C:\Program Files\CrashPlan PROe Server\content-custom\Default-custom\shared\custom
  2. Open or create the file properties.json
  3. Paste the following into that file:
    /* ============ Primary button color =========== */
    .btn.btn-flat.btn-default.c42-orange,
    .btn.btn-flat.btn-default.c42-orange:hover,
    .btn.btn-flat.btn-default[disabled],
    .btn.btn-flat.btn-default:hover[disabled] {
        background: #878787;
    }
    
  4. Replace the hex color code (#878787 in the above example) with the hex color code of your desired color.
    Several online tools can help you identify a hex color code, such as W3Schools's HTML Color Picker.
  5. Save the file.
  6. Clear your browser's cache and open your administration console's sign-in screen to see your customized button colors.

Show account recovery links

The administration console sign-in screen can display two account recovery links:

  • Sign up for an account
  • Forgot your password?

These links are hidden by default. To show these links:

  1. On your Code42 server's file system, navigate to, or create, the custom folder:
    • Linux: /opt/proserver/content-custom/Default-custom/shared/custom
    • Windows: C:\Program Files\CrashPlan PROe Server\content-custom\Default-custom\shared\custom
  2. Open or create the file properties.json
  3. Add the following to properties.json:
    {
    "showAccountRecoveryLinks": true
    }
    
  4. Save the file.
  5. Clear your browser's cache and open your administration console's sign-in screen to see your account recovery links.