Troubleshooting

Solutions to common problems you might encounter with Termial.

Connection Issues

SSH Connection Failed

Symptoms: "Connection refused", "Connection timed out", or "Host not found"

Solutions:

1. Verify the hostname/IP: Ensure you've entered the correct address
2. Check the port: Confirm SSH is running on the specified port (default: 22)
3. Test network: Try pinging the server from your terminal
4. Check firewall: Ensure your firewall allows outbound SSH connections
5. Server firewall: Ask the server admin if SSH access is allowed from your IP

Authentication Failed

Symptoms: "Permission denied", "Authentication failed"

Solutions:

1. Check username: Verify the username is correct
2. Check password: Re-enter your password carefully
3. Check SSH key: Ensure you're using the correct private key
4. Key permissions: On macOS/Linux, ensure key file permissions are 600:

   chmod 600 ~/.ssh/id_rsa
   

5. Key format: Ensure your key is in the correct format (PEM, OpenSSH)

Host Key Changed Warning

Symptoms: Warning about host key mismatch

Causes:

• Server was reinstalled
• Server IP changed to a different machine
• Possible security issue (man-in-the-middle)

Solutions:

1. Verify legitimacy: Confirm with the server admin that the key should have changed
2. Remove old key: If legitimate, remove the old host key entry
3. Reconnect: Accept the new host key

Connection Drops

Symptoms: SSH sessions disconnect unexpectedly

Solutions:

1. Network stability: Check your internet connection
2. Server timeout: The server may be closing idle connections
3. Keep-alive: Enable keep-alive in connection settings
4. Firewall timeout: Some firewalls close idle TCP connections

AI Issues

AI Not Responding

Solutions:

1. Check sign-in: AI features require being signed in
2. Check plan: Some AI features require Pro or Team plan
3. Check limits: You may have reached your daily AI request limit
4. Internet connection: Ensure you have internet access

AI Generates Wrong Commands

Tips:

1. Be specific: Include details like OS, shell, what you're trying to do
2. Provide context: Enable context mode so AI can see your terminal output
3. Review before running: Always check commands before executing

Sync Issues

Data Not Syncing

Solutions:

1. Check sign-in: Ensure you're signed in
2. Check plan: Sync requires Pro or Team plan
3. Check passphrase: You need to unlock your vault/encryption
4. Force sync: Try forcing a sync from Settings → Account
5. Internet: Ensure you have internet connectivity

Sync Conflict

Symptoms: Local and cloud data differ

Solutions:

1. Let it merge: Termial uses timestamps to merge changes
2. Force sync: Force a sync to resolve
3. Export backup: Export a backup before making changes

App Issues

App Won't Start

macOS Solutions:

1. Check Gatekeeper: Right-click app → Open
2. Check permissions in System Preferences → Privacy & Security
3. Try reinstalling the app

Windows Solutions:

1. Run as administrator
2. Check Windows SmartScreen settings
3. Try reinstalling the app

Linux Solutions:

1. Ensure AppImage is executable: chmod +x Termial*.AppImage
2. Check for missing dependencies
3. Try running from terminal to see error messages

App Crashes

Solutions:

1. Restart app: Close and reopen Termial
2. Update app: Ensure you have the latest version
3. Clear cache:
   • macOS: ~/Library/Caches/Termial
   • Windows: %APPDATA%\Termial\Cache
   • Linux: ~/.config/Termial/Cache
4. Report bug: Contact support with crash details

High CPU/Memory Usage

Solutions:

1. Close unused terminals: Each terminal uses resources
2. Limit scrollback: Very long terminal output uses memory
3. Restart app: Clears accumulated memory usage

Docker Issues

Docker Not Detected

Solutions:

1. Install Docker: Ensure Docker is installed
2. Start Docker: Ensure Docker daemon is running
3. Configure path: Manually set the Docker path in Settings
4. Permissions (Linux): Add your user to the docker group:

   sudo usermod -aG docker $USER
   

Can't Access Container Files

Solutions:

1. Container must be running: File browser needs a running container
2. Check permissions: You need permission to read files in the container

Getting Help

Contact Support

If you can't resolve an issue:

1. Email: support@termial.app
2. Include:
   • Termial version (Settings → About)
   • Operating system and version
   • Steps to reproduce the issue
   • Any error messages

Reporting Bugs

Help us improve by reporting bugs:

1. Describe what you expected to happen
2. Describe what actually happened
3. Include steps to reproduce
4. Share any error messages or screenshots