Skip to main content
The SC Agent is a lightweight, open-source utility that enables web-based console access to your computes directly from the Strettch Cloud dashboard. It manages the SSH connection between your browser and the compute to provide seamless terminal access without requiring SSH client software. Supported Systems: Ubuntu 20.04+, Debian 8+ View the source code on GitHub

​
Automatic Installation

The SC Agent installs automatically when you create a new compute instance. No action needed—just wait a few minutes after creation, then access your console from the dashboard.

​
Manual Installation

Need to install the agent on an existing instance? Here’s how: Run this single command to install the agent: 
curl -sSL https://repo.cloud.strettch.com/console/install.sh | sudo bash
The script will automatically detect your OS, set up repositories, and install the agent: 
--- Installing sc-console-agent for noble ---
-> Cleaning up old repository configurations...
   -> Updating package lists
   -> Installing prerequisites
   -> Downloading GPG key
   -> Adding repository
   -> Updating package index
   -> Installing sc-console-agent
...
Setting up sc-console-agent (0.1.12) ...
Configuring SC-Agent...
ℹ️  Creating required directories...
ℹ️  Downloading latest agent configuration...
✅ Agent configuration downloaded successfully
ℹ️  Enabling sc-console-agent.service...
✅ sc-console-agent.service enabled
ℹ️  Starting services...
✅ sc-console-agent.service started successfully

╔════════════════════════════════════╗
║ SC-Console-Agent Installation Done ║
╚════════════════════════════════════╝

Service Status:
  • Main Service: active
  • Auto-Update:  active

✅ sc-console-agent installed successfully!

​
Review Before Installing

Prefer to inspect the script first? Download and review it: 
curl -sSL https://repo.cloud.strettch.com/console/install.sh

​
Verify Installation

Check that the agent is running: 
systemctl status sc-console-agent
You should see Active: active (running): 
● sc-console-agent.service - SC Console Agent - Secure compute console access management
     Loaded: loaded (/etc/systemd/system/sc-console-agent.service; enabled; preset: enabled)
     Active: active (running) since Tue 2025-10-14 10:12:20 UTC; 38s ago
       Docs: https://docs.cloud.strettch.com/agents/sc-console-agent
   Main PID: 578570 (sc-console-agen)
      Tasks: 8 (limit: 9435)
     Memory: 1.9M (peak: 2.4M)
        CPU: 41ms
     CGroup: /system.slice/sc-console-agent.service
             └─578570 /usr/bin/sc-console-agent
Access your console from the dashboard within a few minutes. To check the installed agent version: 
dpkg -l | grep sc-console-agent

​
Managing the Agent

​
Basic Commands

sudo systemctl start sc-console-agent

​
Auto-Start on Boot

sudo systemctl enable sc-console-agent

​
Viewing Logs

sudo journalctl -u sc-console-agent -f

​
Updates

The agent updates automatically. You can also trigger updates manually: 
sudo systemctl start sc-console-agent-updater

​
Uninstalling

To completely remove the agent: 
sudo apt-get purge sc-console-agent
The uninstall process will stop all services and remove the agent: 
Reading package lists... Done
Building dependency tree... Done
The following packages will be REMOVED:
  sc-console-agent*
After this operation, 7,449 kB disk space will be freed.
Do you want to continue? [Y/n] Y
...
Removing sc-console-agent (0.1.12) ...
Removing SC-Agent (keeping configuration)...
Stopping sc-console-agent-update-scheduler.timer...
Stopping sc-console-agent.service...
Disabling sc-console-agent-update-scheduler.timer...
Disabling sc-console-agent.service...
SC-Agent removed (configuration preserved in /etc/sc-console-agent)
Purging configuration files for sc-console-agent (0.1.12) ...
Note: After uninstalling, console access will be unavailable. You’ll need to use SSH with password authentication or SSH keys instead.

​
Troubleshooting

​
Console Not Working?

  1. Verify the agent is running: 
    systemctl status sc-console-agent
  2. Check recent logs: 
    sudo journalctl -u sc-console-agent -n 50
  3. Restart the service: 
    sudo systemctl restart sc-console-agent
  4. Ensure firewall allows port 22 (SSH - for internal communication) and port 60500 (UDP - for console agent)

​
Need Help?

Contact support at cloud@strettch.com with:
  • Output from systemctl status sc-console-agent
  • Recent logs: journalctl -u sc-console-agent -n 100
  • Your compute instance ID
  • Description of the issue

​
Security

The agent uses encrypted communication, cryptographic signatures, and port knocking for secure access. It runs with minimal privileges and updates automatically for security patches.