Now that the liberTV jailbreak for tvOS 10-10.1 has been out for a while, many of our readers will have given it a go. If you haven’t tried it yet, you can use our guide to get it up and running on your Apple TV.
Once you’re jailbroken, you may want to tinker around with the device, grab your apticket off of it, or investigate the filesystem. To do this you’ll need to connect to it from a computer via SSH. In this guide we’ll take you through how to do just that.
The liberTV jailbreak comes with an SSH client included, called Dropbear. This means that we don’t need to install any SSH packages to our Apple TV as we would with a jailbroken iOS device. Instead, we just need to connect, and configure it for use.
How to SSH to your Apple TV 4
1) Ensure your Apple TV is in a jailbroken state. Run the liberTV jailbreak until it succeeds, and then hit the Respawn Dropbear button for good measure.
2) Open up the Settings app on your Apple TV and navigate to the Network section.
3) Take note of your IP Address which is displayed on the Network page.
4) On your computer, launch Terminal from /Applications/Utilities, or via Spotlight.
5) At the prompt, type the following command, and hit Enter to connect to your Apple TV via SSH:
Replace YOUR_IP_ADDRESS_HERE with the IP address you noted down in Step 3. For example, in my case the command was:
6) If Terminal asks you to confirm connecting, simply type yes, and hit Enter to continue.
7) When prompted for a password, enter the default password which is alpine.
8) When the prompt appears reading -bash-3.2#, you are connected via SSH to your Apple TV 4.
We must now change our default password from alpine to something else! Otherwise, anyone on your network can connect to and control your Apple TV.
9) At the -bash-3.2# prompt, enter the following command:
To prevent bricking of the device, the liberTV developer has installed all the binaries you may need in a temporary folder rather than in their traditional places on the filesystem. The command above widens our path so that we can invoke them as we normally would. Without it, most commands we try to issue will fail as the system cannot find the requisite binary to use it.
10) Now that we have our commands at our fingertips, we can change our root and mobile passwords just as we would on a jailbroken iOS device. First, type passwd to change the root password.
11) The Terminal prompt will now ask you to enter a new password twice. Pick a strong one and type it in carefully, the letters will not show in Terminal as you type.
12) Once you have set a root password, type passwd mobile to change the mobile password too.
13) Do the same as before, entering a new mobile password twice to set it.
Do not lose or forget these passwords!
That’s all we have to do. When you SSH into your Apple TV in future, follow Steps 1-6. When it asks for a password, enter the root password which you set in Step 11.
If you want to tinker around once you’ve connected to your Apple TV via SSH, you will need to issue the command in Step 9 once each time you open an SSH session in Terminal. If you don’t, none of your favourite commands such as ls or scp will be available to you.
Do not overwrite any of the existing system binaries on the Apple TV whilst tinkering, or you will brick your Apple TV and lose your jailbreak. That is why the developer has left his binaries in a temporary folder, so as not to interfere with or overwrite the existing system binaries.
Are you running the liberTV jailbreak? Had you been having trouble with SSH on it? Do you need any more help with this guide? Let me know in the comments.