Troubleshooting
Solutions to common issues with JumpTerm connections, sync, and vault access.
Connection Issues
"Connection refused" or "Connection timed out": Verify that the hostname and port are correct and that the SSH service is running on the remote host. Check that any firewalls between you and the host allow traffic on the SSH port. Try connecting with the standard ssh command to rule out a JumpTerm-specific issue.
"Host key verification failed": The remote host's key has changed since you last connected, which could indicate a legitimate server rebuild or a man-in-the-middle attack. If you trust the change, remove the old key from Settings > Known Hosts and reconnect.
"Authentication failed": Double-check your username and credentials. If using key-based auth, ensure the correct private key is selected and that the corresponding public key is in the remote host's ~/.ssh/authorized_keys. If using an SSH agent, confirm the agent is running and the key is loaded.
Sync Issues
"Vault not syncing": Check your internet connection. JumpTerm requires connectivity to sync vault changes. If you are online but sync is not working, try forcing a sync from Settings > Vault > Force Sync. If the issue persists, check the sync log in Settings > Advanced > Logs.
"Sync conflict detected": This occurs when the same vault item was modified on two devices before either could sync. JumpTerm will show both versions and let you choose which to keep, or merge them manually.
Vault Issues
"Vault unlock failed": Ensure you are entering the correct passphrase. Passphrase entry is case-sensitive. If you have changed your passphrase recently, make sure you are using the new one. If you have forgotten your passphrase and have no other authorized devices, your vault data cannot be recovered.
Slow vault unlock: The Argon2id key derivation is intentionally slow to resist brute-force attacks. On older hardware, unlock may take a few seconds. If it takes more than 10 seconds, consider adjusting the parameters in Settings > Security > Advanced.