Skip to main content

This article applies to Cloud.

Other available versions:

Version 6icon.qnmark.png

Available in:

Small Business
Code42 Support

Deploy Code42 apps for manual sign on

This article applies to Cloud.

Other available versions:

Version 6icon.qnmark.png

Available in:

Small Business


This article describes how to configure deployment packages to open Code42 app interfaces automatically on users' desktops. Backups begin when users sign in to your Code42 environment.


This article assumes you understand the introduction to deployment provided by the article Prepare to deploy Code42 client apps.

These instructions apply to the Code42 cloud. If you work in an on-premises Code42 environment, see Manage app installations in your Code42 environment

To use these deployment tools, you need to sign in to your administration console as a user with the role:

Step 1: Identify the deployment organization

In your administration console, create or identify an organization that has at least one destination where backups can auto-start.

Check configuration of the organization, as follows:

  1. Sign in to the administration console.
  2. Select Administration > Organizations > Active.
  3. Select an organization.
  4. Note the organization name; you will need it later.
  5. Select DEVICE BACKUP DEFAULTS > Backup.
    • DESTINATIONS should list at least one destination name and Yes.
      Device backup destinations yes
    • The other possible value, DESTINATIONS ... Auto-start, means endpoint backups do not start until users manually select a destination. In the Code42 app interface, see Tools > Options > Destinations.device backup destinations auto
    • To configure destinations, go to the organization's action menu. Select Device Backup Defaults > Backup > Destinations.
  1. Select DEVICE BACKUP DEFAULTS > Network.
  2. Note whether PROXY is enabled; you will need that information later.
  3. If necessary, change organization configuration. In the action menu in the upper-right, select Edit.

Step 2: Create the deployment policy

Define the deployment policy for the organization you identified in Step 1.

  1. In the administration console, select Administration > Client Management > Deployment.
  2. Select Create New Deployment Policy or Create New Policy.
    The prompt differs depending on whether you see the initial welcome screen or your list of existing policies.
  3. Enter a Policy Name to describe this policy.
  4. At How should new users register? select the organization you identified at Step 1, above.
    If your organization's name is grayed out in the menu, that organization already has a policy.
    You may edit or delete that existing policy.
  5. At Do you want to automatically register users?, select No.
    Organizations using local authentication have no choice: No is selected. Yes is greyed out.
  6. At Which operating systems, select the systems you will deploy Code42 apps to.
  7. For each operating system you select, select Add a custom batch/bash script.
    Provide a script that identifies the username and home directory that the Code42 app will provide when it registers with your Code42 environment. The script must end by echoing the username and user home directory. The username must be an email address. For details, see the script reference.
    echo C42_USERNAME=<value>
    echo C42_USER_HOME=<value>
    The Code42 cloud requires a custom script
    Because user names in the Code42 cloud must be email addresses, deployments for connection to the Code42 cloud always require a customized user detection script (Windows, Mac). The default script will not work.
  8. At Do your clients need a proxy URL, select No or Yes, depending on what you determined at Step 1, above.
  9. At Launch desktop app after initial install, select Yes.
    The desktop interface opens so that users can create passwords and submit their credentials.
  10. Click Save.
    The Policy Saved dialog appears.
  11. Click Done.
    You do not need to save or download the installation properties now. You can easily reach them later, as you configure your deployment software.

Example username detection scripts for the Code42 cloud

Note the lines in the scripts that modify a username in order to match an email-address for the Code42 cloud. In those lines, replace @<yourcompany>.com with the suffix for your addresses.

@echo off
rem Use sysnative when running 32-bit on a 64-bit processor
if "%PROCESSOR_ARCHITEW6432%"=="" goto native
   %SystemRoot%\Sysnative\cmd.exe /c %0 %*
rem Change code page to UTF-8
CHCP 65001
for /f "TOKENS=2*" %%a in ('reg query "HKLM\SOFTWARE\Microsoft\Windows\CurrentVersion\Authentication\LogonUI" /v LastLoggedOnUser') do set current_domain_user=%%b
echo current_domain_user = %current_domain_user%
for /f "TOKENS=1,2 DELIMS=\" %%a in ("%current_domain_user%") do set current_domain=%%a& set current_user=%%b
echo current_domain = %current_domain%
echo current_user = %current_user%
if "%current_user%" == "" (
   set current_user=%current_domain%
   echo current_user = %current_user%
if NOT "%current_user%" == "" (
   echo C42_USERNAME=%current_user%@<yourcompany>.com
   echo C42_USER_HOME=C:\Users\%current_user%
function main() {
    local user=$(last | egrep 'console.*still' | egrep -v 'root|admin|reboot|shutdown|local|_mbsetupuser' | awk '{print $1}' | sort -u | head -n1)
    echo "C42_USERNAME=${user}@<yourcompany>.com"
    echo "C42_USER_HOME=$(dscl . -read "/users/${user}" NFSHomeDirectory | cut -d ' ' -f 2)"
main "$@"

Step 3: Deploy Code42 apps to user devices

Retrieve installation properties from your deployment policy as follows:

  1. Sign in to the administration console.
  2. Select Administration > Client Management > Deployment.
  3. In the list of policies, click on the name of the policy you want to use.
  4. Copy deployment properties from the policy:
    • Windows or Linux: Copy the properties and paste them into your deployment software.
    • Mac: Download the file and provide it to your deployment process.

Distribute installation properties and Code42 app installers to your target devices. Then run the installers.
Details for those two tasks depend on your device management tool and endpoint operating systems:

Step 4: Users sign in 

On Windows and Mac devices, the Code42 app opens on the desktop automatically.
On Linux, users should run this command:/usr/local/crashplan/bin/CrashPlanDesktop

Instruct users to provide names and passwords as prompted by the Code42 app.

For details, direct users to Sign up with newly deployed Code42 app.


If a user opens the desktop UI for a newly deployed Code42 app, but the UI never progresses beyond the message Connecting... , then the deployment has probably failed.

connecting error

Confirm the error as follows:

  1. Find service.log.0 in one of these locations:
    • Windows: C:\ProgramData\CrashPlan\log
      To view this hidden folder, open a file browser and paste the path in the address bar. If you installed per user, see the file and folder hierarchy.
    • Mac: /Library/Logs/CrashPlan
      If you installed per user, see the file and folder hierarchy.
    • Linux: /usr/local/crashplan/log
  2. Open service.log.0 with a text editor.
  3. Find deployment errors by searching for Deploy::, for example:
    deploy:: Unable to make request
    Deploy:: Unable to process deployment package, USERNAME_NOT_IN_OUTPUT

Step 5: Verify success

After users sign in, check that deployments succeed by reviewing the number of devices signed in to your organization and backing up data.

  1. Sign in to the administration console.
  2. Select Administration > Organizations > Active.
  3. Select the organization you deployed to.
  4. At the top of the window, click the value under Devices.
    The number of devices listed for your org should match the number of devices you deployed Code42 apps to.
    The quantity of data stored for each device should be greater than zero.