Support
Frequently asked questions about the app.
Is Basalt free?
Yes. The app is free and complete, with no in-app purchases or advertising. Anyone who installs it during this phase keeps every feature even if it is priced in the future: the entitlement is tied to the Apple Account, including after reinstalling or on another device.
Is an account required?
No. Basalt has no accounts and no servers of its own. Syncing across devices uses the user's iCloud account.
Which devices are supported?
iPhone and iPad running iOS or iPadOS 26 or later. Apple Watch can run snippets through the iPhone. There is no Mac version.
Which authentication methods are supported?
Password, ed25519 and RSA keys, and keyboard-interactive, the method commonly used for two-step verification. Jump hosts are supported through ProxyJump. For devices without SSH, telnet is included and always marked as unencrypted.
Where are private keys stored?
In the device's Keychain, protected by Face ID or the passcode. A key can be moved to iCloud Keychain to make it available on other devices; it is then no longer protected by biometrics, which is a limitation of the system.
How can existing servers be imported?
An ~/.ssh/config file can be imported and exported from Settings. Private keys are imported separately.
The connection to the server fails.
When a connection does not complete, the red capsule above the terminal shows the step that failed: name resolution, the port, the SSH handshake or the key. Network diagnostics also offers ping, port, DNS and TLS checks.
What happens if the network changes or the app closes?
Basalt reconnects automatically when the network changes. If the server uses tmux, it can reattach to the session, so work continues even if iOS has closed the app.
Tunnels stop when leaving the app.
On iPhone, iOS suspends networking for apps in the background, and tunnels with it. This is a limitation of the system, and Basalt shows the reason in the tunnel itself.
How can a server's files be accessed from the Files app?
Each server can be enabled in its settings with “Show in Files”. Basalt generates a dedicated key for this, which never leaves the device.
Wake-on-LAN does not start the machine.
The cause is usually the target machine: the feature must be enabled in the BIOS or UEFI and in the operating system, and the connection must be wired. iOS must also allow Basalt to access the local network.
What does the game server need?
A Linux machine with systemd and SSH access. Basalt installs the server in its own folder with a systemd unit, without Docker or additional programs, and can remove it completely from within the app.
Does Basalt collect data?
No. The app contains no analytics or advertising and does not communicate with any server of the developer. Full details are in the privacy policy.
Contact
Questions not answered here can be sent to help@usebasalt.app. To help us respond, please include the device model, the iOS version and the steps taken. Support will never ask for keys or passwords.