CrashPlan is designed with the assumption that the CrashPlan app and the CrashPlan service are running on the same machine. Although running the CrashPlan service on a machine without a graphical environment (i.e. running a headless client) is an unsupported feature, this article provides a process for doing so that some users have found useful.
The information presented here is intended to offer information to advanced users. However, Code42 does not design or test products for the use described here. This information is presented because of user requests.
Our Customer Champions cannot assist you with unsupported processes, so you assume all risk of unintended behavior. You may want to search our support forum
for information from other users.
A headless CrashPlan app means that the CrashPlan service is running on a machine without a graphical environment (headless mode), like a Linux or Solaris server. Running a headless CrashPlan app allows you to remotely administer the CrashPlan service that is running as a backup destination.
CrashPlan is comprised of two components:
- CrashPlan service: This is always running from the moment you install CrashPlan and continues to run even if you log out. It is responsible for the actual backup functions.
- The CrashPlan app: This runs as an application that you can launch from a user's desktop. This is what most people mean when they refer to “CrashPlan.” Headless means you do not open the CrashPlan app.
Use an SSH tunnel to connect the CrashPlan app on one machine (220.127.116.11) to the CrashPlan service on a computer that is text-only (18.104.22.168).
- Install and start engine on the text-only server (22.214.171.124).
- Install the CrashPlan app on the CrashPlan Desktop computer (126.96.36.199).
Use Mac, Windows, Linux. It doesn't matter which platform you use.
- Close the CrashPlan app if it's running.
- On 188.8.131.52, navigate to CrashPlan\conf on 184.108.40.206.
- Open file ui.properties in a text editor. (locations)
- Edit the line:
- Open a terminal window on 220.127.116.11.
- Using SSH, forward port 4200 on 18.104.22.168 to port 4243 on 22.214.171.124.
The command is:
ssh -f -L 4200:localhost:4243 email@example.com -N
- On 126.96.36.199, open the CrashPlan app.
Your CrashPlan app is now connected to the CrashPlan service on 188.8.131.52. You can now configure CrashPlan on 184.108.40.206.
Switch Your CrashPlan App Back
When you're done using the CrashPlan app on the text-only computer, switch your CrashPlan app back.
- On 220.127.116.11, open the ui.properties file in a text editor. (locations)
- Comment out the servicePort line.
- Save your changes.
Putty is a free Windows SSH client that you can use to do the port forwarding necessary to control a remote CrashPlan client.
Before You Begin
- Be sure CrashPlan is running on your remote machine.
- Verify on the headless machine (with netstat) that it is listening on port 4242 on all addresses and on port 4243 on the local address (this is the UI service port).
netstat -na | grep LISTEN | grep 42
Output should look like this:
username$ netstat -na | grep LISTEN | grep 42
tcp4 0 0 *.4242 *.* LISTEN
tcp4 0 0 127.0.0.1.4243 *.*
We want to use SSH to tunnel a local Windows port (4200) to the remote host's service port (4243).
- Enter the IP for SSH as you normally would, but don't open the connection yet.
- In the Connection > SSH > Tunnels section, add the following:
- Click the Add button.
If you don't click the Add button, the CrashPlan connection will fail.
- Now open the session and log in.
- You can use telnet to confirm the connection:
telnet localhost 4200
A successful connection displays “Connected to HOST_IP” with a long, encrypted string. It looks something like this:
username$ telnet 10.10.42.183 4200
Connected to 10.10.42.183.
Escape character is '^]'.
Once you have confirmed the connection you should be able to stop the local CrashPlan app. Make sure the servicePort is 4200 in the conf/ui.properties file and restart the CrashPlan app.
UI.PROPERTIES File Location
- Linux (if installed as root): /usr/local/crashplan/conf/ui.properties
- Mac: /Applications/CrashPlan.app/Contents/Resources/Java/conf/ui.properties
- Solaris (if installed as root): /opt/sfw/crashplan/conf/ui.properties
- Windows: C:\Program Files\CrashPlan\conf\ui.properties
Headless Mode FAQ
How do I put the CrashPlan app into Headless Mode?
You do not have to do anything to run in 'headless mode'. Headless just means you do not run the CrashPlan app UI. The CrashPlan service is running once you install the CrashPlan app.
There are numerous resources on the Internet for installing CrashPlan on a NAS device. Here are a few how-to articles for several popular devices:
For additional information on Putty and SSH port forwarding review the following: