Skip to main content
Code42 Support

Install the Code42 platform (on-premises)

Available in:

StandardPremiumEnterprise
Small Business
Applies to:

Overview

This article describes how to install Code42 for Enterprise on premises.

Setting up the Code42 platform involves:

  • Installing an on-premises Code42 server and configuring it as an authority server
  • Adding client package files to your authority server
  • Backing up a device running the Code42 app to the authority server

Before you begin

To avoid security risks, keep your operating system updated.

Code42 server Host Device
  • Choose a server to host the Code42 server application that meets the Code42 server system requirements.
  • (Optional) Install and run a PostgreSQL database server for your Code42 server's use. By default, a Code42 server uses a built-in H2 database. Code42 recommends the PostgreSQL option for environments with 10,000 or more endpoint users. See the article Using PostgreSQL In Your Code42 Environment.
  • Open required ports on the device that will host the Code42 server.
  • Assign a hostname or IP address for the Code42 platform. IPv4, IPv6, or dual stack (v4 and v6) addresses can be used.
    Additional configuration steps are required to use dual stack IPv4 and IPv6 in your Code42 environment.
Client Devices

Set up your Code42 authority server

Step 1: Get a master license key

If you already have a master license key, skip to Step 2: Download and install the Code42 server software.

A master license key activates your Code42 server and is required to use the software. When you request a master license key, you receive a 30-day evaluation license that has full functionality for an unlimited number of Code42 apps. If you purchase Code42 for Enterprise after your trial, you continue to use the same master license key.

  1. Go to https://www.code42.com/trial.
  2. Enter your information, then click SUBMIT.
  3. A confirmation email is sent to the email address you provided.
  4. A Code42 representative contacts you and provides your master license key.
Safely Store Your Master License Key
Keep the
master license key in a safe place. You need it when purchasing user subscriptions, adding storage servers, or recovering an administrator password.

Step 2: Download and install the Code42 server software

Perform these steps from the device that will host the Code42 server.

  1. Download the Code42 server software for your operating system.
    If you skipped Step 1 above, you can download the installation file from Code42 platform Installers Version 6.x.
  2. Launch the installer.
    • Windows: Double-click the MSI file.
    • Linux:
      1. Unpack the TGZ archive.
      2. Navigate to the location of the unpacked files with cd.
      3. Execute the install.sh Bash script from the directory in which it resides.
        User privileges Example command
        Installation as root

        sudo ./install.sh

        Installation as a user

        ./install.sh

  3. Follow the prompts to complete the installation.
  4. (Optional) If you have chosen to use a PostgreSQL database instead of the default H2 database, connect the Code42 server to your PostgreSQL database by answering the related prompts.
    The process starts with two prompts. Answer yes to both:
Server install complete, beginning database configuration.
Are you installing an authority? (y/n)
Would you like to use an external PostgreSQL database? (y/n)

For details, see Using PostgreSQL And Code42.

When installation is complete, the installer starts the Code42 server service and launches the administration console, which is the browser-based management console for your Code42 environment.

  1. (Optional) We recommend you increase Java heap space to up to one-half of the total RAM available on the Code42 server. Increasing Java heap space enhances performance as the number of users and devices in your Code42 environment increases.

Step 3: Activate your Code42 server

Use the master license key to activate your Code42 server and create an administrator account.

  1. Open the administration console:
    • (Windows) From the Start menu or Start screen, open Code42 Enterprise Server Admin Console.
    • Use a web browser to navigate to your server's hostname or IP address via HTTPS on port 4285.
      • Hostname example: https://master-server.example.com:4285/console
      • IPv4 example: https://192.0.2.100:4285/console
      • IPv6 example: [fd00:c0de:42:0:20c:29ff:fe62:1507]:4285/console
  2. Acknowledge the certificate error displayed by your browser and proceed to access the administration console.
    This error appears because the Code42 server ships with a self-signed SSL certificate. You have the option to install a CA-signed SSL certificate later in the configuration process.
  3. Enter information for your Code42 environment administrator account.
    • This creates a local administrator user account within your Code42 environment. The local administrator user has full administrative permissions.
    • You do not need to use the same credentials you provided to request the master license key.
    • System alerts are sent to the email address associated with this administrator account.
    • The Code42 environment administrator account cannot be used for backing up devices.
  4. Enter your master license key, then click CREATE ACCOUNT.

Step 4: Configure Code42 server network addresses

The Primary network address and Secondary network address are used for client-to-server communication and server-to-server communication. The Code42 server communicates by default on TCP port 4287.

Device connectivity
The Primary network address and Secondary network address must be configured correctly in order for devices to connect to your Code42 server.
  1. In the administration console, navigate to Settings > Server.
  2. Enter the Primary network address of your Code42 server.
    You can specify a hostname or an IP address, but a hostname is recommended for most environments. Do not add "http://" to the address.
    • Hostname example: master-server.example.com
    • IPv4 example: 192.0.2.100
    • IPv6 example: [fd00:c0de:42:0:20c:29ff:fe62:1507]
  3. Enter the Secondary network address of your Code42 server.
    You can specify a hostname or an IP address, but an IP address is recommended in order to maintain connectivity in case DNS services are unavailable. Do not add "http://" to the address.
    • Hostname example: master-server.example.com
    • IPv4 example: 192.0.2.100
    • IPv6 example: [fd00:c0de:42:0:20c:29ff:fe62:1507]
  4. For both the Primary network address and Secondary network address, enter the TLS port number of your Code42 server. The default is 4287.
    The Legacy port number is set automatically as 5 less than the TLS port. The default is 4282.
  5. Click Save.

Step 5: Install a CA-signed SSL certificate

Install a CA-signed certificate on your Code42 server to increase security and prevent certificate errors.

Testing and evaluation
We recommend installing a CA-signed SSL certificate in production environments. If you are installing a Code42 server for evaluation or testing purposes, installing an SSL certificate is optional.

Step 6: Create a user account

A user account is required to access the Code42 app. There are three ways to add users from the administration console; for simplicity, this procedure describes the manual method.

  1. (Version 6.5.x and later) In the administration console, select Users > Active.
    (In versions 6.0.x) select Users.
  2. Click Add a new user Add User.png, then select Add Users.
  3. Enter the user's information, then click Add User.

    First Name, Last Name, and Email Address are optional.

Add Code42 apps to your authority server

First, add the client installation and upgrade files for the Code42 app to your authority server, then they can be distributed to your users and devices. You can choose which versions and operating systems you want to make available in your Code42 environment using the steps below.

Administrator welcome message in 5.3 and later

  1. Sign in to the administration console using the local administrator account you created in Step 3.
    The administrator welcome message, "Hello! Download clients to protect your devices." displays.
  2. From the welcome message, click Yes, Continue to navigate to App Downloads.
    Alternatively, from the navigation menu on the left, select App Downloads.
  3. From Newer versions available from Code42, select Add for clients you want to make available in your Code42 environment.
    Your authority server must be connected to the Internet to add clients available from Code42 directly from this list. Alternatively, you can upload compatible client package files obtained from the Code42 support site.
  4. Continue to add clients as needed for additional versions and operating systems.

For additional information, see our full tutorial on Add clients to your Code42 environment.

Back up your device using the Code42 app

Step 1: Download the Code42 app installer

  1. From the device that you want to back up to your Code42 server, open the administration console in a web browser and sign in.
    An administrator or user can sign in to download the Code42 app.
  2. From the navigation menu on the left, select App Downloads.
  3. From Available on your Code42 server, click the download icon for your operating system.
  4. Proceed to Step 2 to install the Code42 app.

Step 2: Install the Code42 app

  1. Launch the Code42 app installer.
    • Windows: Double-click the MSI file.
    • Mac:
      1. Mount the DMG.
      2. Double-click Install CrashPlanPROe.
    • Linux:
      1. Unpack the TGZ archive.
      2. Navigate to the location of the unpacked files with cd.
      3. Execute the install.sh Bash script from the directory in which it resides. For example:
        ./install.sh
        
  2. Follow the prompts to complete the installation.
Detailed installation instructions
For more detailed installation instructions, see Install the Code42 app.

Step 3: Sign in and start backup

When installation is complete, the Code42 app launches. Follow the steps below for your version of the Code42 app to sign in and start backing up this device.

  1. Enter the Username and Password of the account you created in Step 6 above.
    The local administrator account cannot be used for backup.
  2. In the Server Address field, enter the IP address or hostname and port number (4282) of your authority server.
    Example: master-server.example.com:4282
  3. Click Continue.

Next steps