1. Test Your SSH Connection
First, confirm that you can connect to your server directly using your SSH credentials, completely outside of the Platforma application.
On Windows: Use an SSH client such as PuTTY.
On macOS or Linux: Use the built-in Terminal application.
Attempt to connect using the exact same credentials (host, username, and password/private key) that you have configured in Platforma. If you cannot connect, you must fix the underlying connection problem (e.g., firewall, incorrect credentials, server configuration) before you can proceed.
2. Verify Network Access
For the connection to work, your server must have internet access and be able to reach our license servers.
From your server's command line, test the connection to both license servers using the ping command. Both must be reachable:
ping 99.83.215.63
ping 75.2.96.100
If these commands fail, it likely indicates a firewall or network configuration issue on your server.
3. Restart Platforma's Server Processes
Stopping and restarting the Platforma processes on your server can resolve temporary issues.
Connect to your server via SSH.
Run the following command to find and stop all running Platforma processes:
Bash
kill $(ps axuw | grep platforma | awk '{print $2}')Note: It is normal for this command to produce no output or an error message if no processes were found.
Return to the desktop app and try the 'Run over SSH' feature again.
4. Start from Scratch
If the problem persists, a clean re-installation of the Platforma components on your server will often solve it. This only removes the application files and will not affect your data.
Stop all processes: First, connect to your server via SSH and run the command below to ensure no Platforma processes are active.
Bash
kill $(ps axuw | grep platforma | awk '{print $2}')Clean up the old installation directory: Next, remove the Platforma SSH directory from your user's home folder.
Bash
rm -rf ~/.platforma_ssh/
Try again: Go back to the Platforma desktop app and select 'Run over SSH' one more time. Platforma will automatically handle the re-installation on the server. Remember to use the same credentials you verified in the first step.