Skip to main content

SSH workspaces

Connect projects on remote servers, configure authentication, and recover SSH tasks.

Connect a server

Qoder CN reads files and runs commands in the remote directory. Make sure the SSH account can read and write the project, then connect the workspace:
  1. Open Settings → Remote connections and add a host. Choose a discovered SSH configuration entry or enter the host address, port, and username directly.
  2. Supply the authentication information offered by the form. For key authentication, select a valid private-key file readable on the local device. Configure a dedicated SSH client or configuration file as described in Specify an SSH client and configuration file, if needed.
  3. Connect and complete authentication. Once connected, select the remote project directory and create a workspace.
  4. Check the host, project path, and branch before sending a task.
After changing connection details, check whether existing workspaces need to be reassociated. Manually disconnecting pauses automatic reconnection without deleting workspaces or task records. Reconnect and verify the remote path when continuing. Use connection errors to check networking and authentication rather than repeatedly creating hosts with the same name. Remote branch controls depend on the host's Git capabilities; check the connection and repository if an action is unavailable. To bring existing remote tasks into Qoder, use Data import.

Remote SSH compatibility and recovery

Qoder provides x64 and ARM64 EL7-compatible runtimes for environments meeting requirements including glibc 2.17, GLIBCXX 3.4.19, and CXXABI 1.3.7. Check distribution-specific dependencies and connection results; this is not a compatibility guarantee for every older Linux system. If a failed managed SSH connection offers a Thin SSH retry, follow that prompt. Thin SSH uses a local Agent to access the remote host through SSH and differs from managed remote execution. This retry does not apply to WSL. In an existing managed SSH task, start a Side Chat to work on a related question in the same remote environment. If the SSH connection drops unexpectedly, the host can continue work it had already accepted. Wait for Qoder to reconnect automatically, or reconnect to the same host when prompted. Open the original task and check the synchronized reply and execution status before deciding whether to send it again.

Specify an SSH client and configuration file

If a host needs a particular SSH client or a separate configuration file, set its paths before connecting. Skip this setup when the defaults work for the host.
  1. Find the host in Settings → Remote connections. Disconnect it if connected, then choose Edit.
  2. Fill in the fields you need:
    FieldValueIf left blank
    SSH client pathAbsolute path to the SSH executable on this computerSelect a client automatically
    SSH configuration file pathAbsolute path to the SSH configuration file on this computerUse the default configuration
  3. Choose Save, then connect to the host. The changes apply only to future connections to this host.
Do not quote paths or use variables or wildcards in the configuration file path. If the client cannot be found, check the executable path. If configuration ownership or permissions are rejected, check that file and any files it includes.