Help & Support

Getting Started

How do I connect to a device via SSH?

From the home screen, tap "New SSH Connection" in the SSH / Network section. Enter the hostname or IP address, port (default 22), username, and password. Tap "Add" to save, then tap the profile to connect.

How do I connect via serial console (Airconsole)?

Make sure your Airconsole/Get-Console device is powered on and nearby. Konsol will automatically discover it via WiFi or Bluetooth. It will appear in the "Discovered Devices" section. Tap it and select a connection profile.

How do I add a device by IP address?

In the "Airconsole Devices" section, tap "Add Device by IP". Enter the IP address and port (default 3696). Tap "Detect Device" to verify it's reachable. Set the number of serial ports and tap "Add Device".

SSH Keys

How do I use SSH key authentication?

Edit an SSH profile and change "Authentication" to "SSH Key". You can either:

Why does my SSH key fail to authenticate?

Common reasons:

Network Tools

Where are the network tools?

Tap the grid icon (▦) in the top-right of the home screen to open Network Tools. You'll find Ping, Port Scanner, DNS Lookup, IP Calculator, Speed Test, Traceroute, SNMP Monitor, Syslog Receiver, and more.

How do I use the speed test?

Open Network Tools, select "Speed Test". Tap the settings icon to configure test duration (5-60 seconds) and download size. Tap "Start" to begin. The test downloads from Cloudflare's network and shows live graphs of throughput and latency.

USB Console Cable

How do I connect via USB console cable?

Konsol supports the Redpark USB-C Console Cable (C4-RJ45V). Plug the USB-C end into your iPhone and the RJ45 end into your device's console port. The cable will appear automatically in the "USB Console" section on the home screen. Tap it to connect. This is a Pro feature.

Can I use a generic USB-to-serial cable?

No. iOS only supports MFi-certified serial cables. Generic USB-C to serial adapters (FTDI, Prolific, CH340, CP210x) are not recognized by iOS. The Redpark USB-C Console Cable is the only compatible option for wired serial on iPhone.

Where can I buy a Redpark cable?

Redpark cables are available at redpark.com. The USB-C Console Cable (C4-RJ45V) is approximately $69 USD.

Quick Button Templates

What are quick button templates?

Templates are pre-built sets of quick-access buttons for specific vendors. Konsol includes built-in templates for Cisco IOS, Cisco NX-OS, Juniper JunOS, Arista EOS, MikroTik RouterOS, Palo Alto PAN-OS, Fortinet FortiOS, and Linux/Unix.

How do I apply a template to a profile?

Edit a connection profile, scroll to the "Quick Buttons" section, enable "Custom buttons for this profile", then tap "Load Template". Select a template to replace the current buttons. You can still add, remove, or reorder individual buttons after applying a template.

Can I create my own templates?

Yes. Customize the buttons for a profile, then tap "Save as Template". Give it a name and it will be saved for reuse across all your profiles. Custom templates sync via iCloud.

Config Backup

How do I backup a device configuration?

While connected to a device via SSH, tap the "Tools" button, then "Backup Config". Select your device type (Cisco, Juniper, Arista, etc.) and tap "Run Backup". The configuration will be captured and saved.

You can also access saved backups from the home screen: tap the ⋯ menu > "Config Manager".

How do I compare two configurations?

Open Config Manager (⋯ menu from home screen), select the "Diff" tab, choose two backups, and tap "Compare". Changes are highlighted: green for additions, red for deletions. Use the "Differences only" toggle to hide unchanged lines and focus on what changed.

Subscriptions

What's included in the free version?

3 saved connections, SSH/Telnet/Serial support, Ping, DNS Lookup, IP Calculator, Port Checker, Airconsole support, command history, and terminal themes.

What does Konsol Pro include?

Everything in Free, plus: unlimited connections, SFTP, all 15+ network tools, config backup & diff, uptime monitoring, session recording, SNMP dashboard, command macros, SSH key auth, jump hosts, multiple sessions, USB console cable support, quick button templates, iCloud sync, widgets, and Siri Shortcuts.

How do I cancel my subscription?

Go to iOS Settings > your Apple ID > Subscriptions > Konsol Pro > Cancel. Your Pro features will remain active until the end of the current billing period.

How do I restore my purchase on a new device?

In Konsol, go to Settings and tap "Restore Purchases". Make sure you're signed in with the same Apple ID you used to subscribe.

Troubleshooting

The app shows a black screen when I tap on something

This can happen due to a navigation timing issue. Try tapping again or tapping a different item first. If the issue persists, force-quit the app and reopen it.

My SSH connection keeps dropping

Enable "Auto-Reconnect" in Settings. Also ensure Background App Refresh is enabled for Konsol in iOS Settings. Note that iOS may suspend the app after extended background time — keep the app in the foreground for long sessions.

Airconsole device not showing up

Ensure WiFi and/or Bluetooth scanning is enabled in Settings. Your device must be on the same network. Check that Konsol has Local Network permission in iOS Settings > Konsol.

Still need help? Contact us.

We typically respond within 24 hours.