How to SSH into KommuVision

Table of Contents

• Laptop Client
  • Putty SSH Client for Windows
  • OpenSSH Client on MacOS
• Mobile SSH Clients
  • JuiceSSH Client
• Troubleshoot SSH Issues
  • When SSH is automatically enabled/disabled
  • Invalid Format when trying to connect
  • No route to host
  • Permission denied (publickey,keyboard-interactive)

Laptop Client

Putty SSH Client

Putty is a simple beginner friendly way to connect to a KommuVision via SSH.

1. Download and install Putty.
2. Get the IP address of your KommuVision in settings under Settings > WiFi > Open WiFi Settings > More Options > Three Dots in Top Left > Advanced (Please make sure your KommuVision and your computer connect to the same WiFi)
3. Make sure Settings > Network > Enable SSH is enabled. It should be green.
4. Open Putty, and enter the hostname as root@<ip_address> where <ip_address> is your device IP and leave the port to 8022

5. Load the private key file in Connection > SSH > Auth > Private key for authentication:

6. Finally, click Open on the bottom of the program, and if all works correctly, an SSH connection will be created. You will see a prompt with "root@localhost:/data/openpilot$"

OpenSSH Client on MacOS

MacOS already comes with a SSH client and has everything you need to SSH into KommuVision. No additional software download or installation required.

1. Open Terminal. You can find Terminal by opening Spotlight in the top-right corner and typing "Terminal".
2. Type in the following command to create the .ssh directory if it isn’t already created.

mkdir -p ~/.ssh/

3. We can use the following command to open a new blank file for us to paste our key into:

vim ~/.ssh/openpilot_rsa

4. After pasting it, press ESC on your keyboard, then type :wq! to save. Then run:

chmod 600 ~/.ssh/openpilot_rsa

5. Make sure your KommuVision and your computer connect to the same WiFi or network.
6. Get the IP address of your KommuVision in settings under Settings > Network > WiFi Settings > Three Dots in Top Right > Advanced and scroll to the bottom.
7. To ssh, just:

ssh root@<IP_ADDRESS_OF_KOMMUVISION> -p 8022 -i ~/.ssh/openpilot_rsa

Mobile SSH Clients

• Android

  • ConnectBot - https://f-droid.org/en/packages/org.connectbot/
  • Termius - https://play.google.com/store/apps/details?id=com.server.auditor.ssh.client
    • Supports Putty .ppk key.
  • JuiceSSH - https://play.google.com/store/apps/details?id=com.sonelli.juicessh

• iOS

  • Termius - https://apps.apple.com/us/app/termius-ssh-shell-console-terminal/id549039908

JuiceSSH Client

1. Download and install JuiceSSH.
2. Get the IP address of your KommuVision in settings under Settings > WiFi > Open WiFi Settings > More Options > Three Dots in Top Left > Advanced (Please make sure your KommuVision and your computer connect to the same WiFi)
3. Make sure Settings > Network > Enable SSH is enabled. It should be green.
4. Open JuiceSSH, and enter the address as <ip_address> where <ip_address> is your device IP and the port to 8022

5. Create a new identity as shown below and set the private key:

6. Import the pem file, which is the private key file:

7. Go back to connections and click on connect.

Troubleshoot SSH Issues

When SSH is automatically enabled/disabled

WiFi
SSH is automatically enabled with a clean KommuVision factory reset. It is disabled once you start installing dashcam or custom software. You then will need to enable SSH through the phone's UI settings if you want to SSH after install. SSH'ing into the phone before installing software (and typing tmux a) is helpful in understanding what is going on if you are having trouble performing your install.

LTE
You can always SSH via the LTE connection with the same methods.

Invalid Format when trying to connect

Something is wrong with your private key. Again, Putty and OpenSSH private keys are in different formats, make sure you are using the correct one.

No route to host

The IP address to your device is wrong in some way. Are both your computer and device on the same network, is the IP address typed correctly?

Permission denied (publickey,keyboard-interactive)

This is a generic authentication error and could mean many things. Did you enable SSH on the device? If you entered a GitHub Username, did you use a private key that matches one in your GitHub account? Did you correctly download and save the private key file? Does the private key have the correct permissions?

port 22: Connection refused

Older devices and OSes only listened on port 8022 in the past. Use port 8022 instead.