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".

Cloud Sync

What is Cloud Sync and how do I enable it?

Cloud Sync keeps your profiles, macros, and saved credentials in sync across iOS, Mac, and Android — over the air, end-to-end encrypted with a password you choose. To enable it, go to Settings → Sync, generate a sync password (or type one you already use on another device), then tap Enable Cloud Sync. The same password on a second device will pull your data automatically.

Can Konsol (or anyone else) read my Cloud Sync data?

No. Your data is encrypted on your device with AES-256 before it ever leaves the app. The encryption key is derived from your sync password using PBKDF2. We do not store, transmit, or have access to your sync password, so we have no way to decrypt your backup. Our cloud storage holds only opaque ciphertext.

This also means: if a court order, hack, or rogue employee got access to our storage, all they would get is encrypted bytes.

What happens if I forget my sync password?

Your encrypted backup becomes permanently unrecoverable — by design. There is no password reset, no recovery email, no backdoor. We cannot help you decrypt it because we never had the key. Your local data on each device is unaffected; you can disable Cloud Sync, generate a new password, and re-upload from any device that still has the data.

How do I disable Cloud Sync and delete my cloud copy?

Go to Settings → Sync → Disable & Delete Cloud Copy. The encrypted backup is removed from our cloud immediately. Your local data on the device is unaffected. After deleting, you can re-enable Cloud Sync at any time with the same or a new password.

What gets uploaded vs what stays on my device?

Uploaded (encrypted): connection profiles, saved SSH and Telnet credentials, SSH private keys, macros, quick buttons and templates, manual device entries, network notes, MAC and IP reference data, code snippets, theme/font preferences.

Never uploaded: session terminal output, command history, screen recordings, log files, configuration backups pulled via Config Manager, or any data you transmit over an active SSH/Telnet/Serial/SFTP connection.

What's the difference between Cloud Sync and iCloud Sync?

They're independent. iCloud Sync uses Apple's iCloud Key-Value Store and iCloud Keychain to sync between your Apple devices only — operated entirely by Apple. Cloud Sync is Konsol's own end-to-end encrypted sync that works across iOS, Mac, AND Android. You can use either, both, or neither. They don't conflict.

I changed something on iOS but my Mac doesn't see it yet

Cloud Sync is debounced — small bursts of edits batch up before uploading to avoid hammering the network. If a sync seems stuck, open Settings → Sync and tap Sync Now to force a manual round-trip. If devices have drifted out of alignment, use Match Cloud (replaces local with cloud) or Replace Cloud With This Device (overwrites cloud with local) — both are destructive, so use them only when you know which copy is the right one.

Cloud Sync says my password is too short

Cloud Sync requires a password strong enough to make brute-force attacks against your encrypted blob impractical. The in-app password generator produces a 20-character random password that meets the strength requirement. Generate one in Settings → Sync → Generate Strong Sync Password, then update the password on your other devices to match.

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.

SFTP File Transfer

How do I upload multiple files or a whole folder?

Mac: drag any combination of files and folders onto the SFTP browser. Folders are walked recursively and the local tree structure is preserved on the remote. You can also use the Upload button (toolbar) to pick multiple files and folders from a Finder dialog.

iOS / iPadOS: tap the Upload button (the up-arrow icon). The Files-app picker now lets you select multiple items at once, and folders are uploaded recursively.

How do I rename a file or folder?

Right-click (Mac) or long-press (iOS) any file or folder, then choose Rename. The current name pre-populates so you only need to change the bits you want different. Works on both files and directories.

My SFTP session disconnected — do I have to start over?

No. SFTP sessions now show a Reconnect button in the toolbar (Mac) and a stale-session banner with reconnect when the server stops responding. Konsol also keeps an idle keepalive running, so most idle disconnects don't happen in the first place.

How do I save folder favorites for quick navigation?

Browse to a folder, tap the star icon in the breadcrumb bar, and give it an optional friendly name. Favorites are per-server and per-profile. Tap the favorites menu (the star button in the toolbar) to jump to any saved path in one tap.

USB / Serial Console Cables

How do I connect via USB console cable on iPhone or iPad?

Konsol supports the Redpark USB-C Console Cable (C4-RJ45V). Plug the USB-C end into your iPhone or iPad and the RJ45 end into your device's console port. The cable appears 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 adapter on iOS?

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

What about Android? Can I use generic USB-to-serial adapters?

Yes. Android supports generic USB-to-serial adapters via USB OTG. Konsol on Android works with FTDI, Prolific, CH340, and CP210x chipsets — the most common adapters used for Cisco-style RJ45 console cables. Plug the adapter in, grant USB permission when prompted, and the device appears in the "USB Console" section.

How do I connect via serial on Mac?

macOS works with any standard USB-to-serial adapter (FTDI, Prolific, CH340, CP210x) — no special cable required. Plug it into your Mac, grant permission if prompted, and the port appears in Konsol's "Serial Ports" section. Multiple adapters can be plugged in at once and used simultaneously.

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 file transfer with multi-file/folder drag-drop, all 20+ network tools, config backup & diff, uptime monitoring, session recording, SNMP dashboard, bandwidth and interface graphs, command macros, SSH key auth, jump hosts, multiple sessions and tabs, session groups, USB console cable support, quick button templates, reference tools (MACs, IPs, snippets, notes), iCloud sync, end-to-end encrypted Cloud Sync, home screen widgets, and Siri Shortcuts.

How do I cancel my subscription?

iOS / iPadOS / macOS: Settings → your Apple ID → Subscriptions → Konsol Pro → Cancel.

Android: Google Play app → profile icon → Payments & subscriptions → Subscriptions → Konsol Pro → Cancel subscription.

Your Pro features 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 → Restore Purchases. Make sure you're signed in with the same Apple ID (iOS / Mac) or Google account (Android) you used to subscribe.

Note: an iOS subscription does not unlock Pro on Android (and vice versa) — the App Store and Google Play are independent billing systems. If you want Pro on both ecosystems, you'd need to subscribe in each.

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. On iOS / iPadOS, also enable Background App Refresh for Konsol in system Settings; on Android, exempt Konsol from battery optimization. Mobile OSes will suspend backgrounded apps after a few minutes either way — keep the app in the foreground for long sessions, or use the Mac app where this isn't a constraint.

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 (iOS / Mac) or Nearby Devices permission (Android).

Still need help? Contact us.

We typically respond within 24 hours.