SC Agent

The SC Agent is a lightweight, open-source utility that enables web-based console access to your computes directly from the Strettch Cloud web console. 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 web console.

Manual Installation

Need to install the agent on an existing instance? Here’s how:

Quick Install (Recommended)

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 web console 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

sudo systemctl stop sc-console-agent

sudo systemctl restart sc-console-agent

systemctl status sc-console-agent

Auto-Start on Boot

sudo systemctl enable sc-console-agent

sudo systemctl disable sc-console-agent

Viewing Logs

sudo journalctl -u sc-console-agent -f

sudo journalctl -u sc-console-agent --since=1h

sudo journalctl -u sc-console-agent -n 100

Updates

The agent updates automatically. You can also trigger updates manually:

sudo systemctl start sc-console-agent-updater

sudo journalctl -u sc-console-agent-updater -f

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 Accessible?

If you can’t access your compute console from the Strettch Cloud web console, follow these steps:

Step 1: SSH into Your Virtual Machine

First, connect to your VM using SSH:

ssh -p 222 root@your-vm-ip-address

Enter your password when prompted. Once logged in, proceed with the following steps.

Step 2: Verify Required Ports are Open

The console requires two ports to function:

sudo netstat -tuln | grep -E ':(22|60124)'

Expected: You should see port 22 (TCP) and port 60124 (UDP) listed as LISTEN If ports are blocked by your firewall, allow them:

sudo ufw allow 22/tcp
sudo ufw allow 60124/udp

sudo iptables -A INPUT -p tcp --dport 22 -j ACCEPT
sudo iptables -A INPUT -p udp --dport 60124 -j ACCEPT

Step 3: Check if the Agent is Running

systemctl status sc-console-agent

Look for: Active: active (running) in the output

Step 4: Take Action Based on Status

If the agent is not installed (you see could not be found):

Go to the Manual Installation section above and install the agent

If the agent is stopped (you see inactive (dead) or failed):

sudo systemctl restart sc-console-agent

sudo systemctl enable sc-console-agent

Step 5: Test Console Access

Wait 30-60 seconds, then try accessing your console from the web console.

Still Not Working?

Contact support at cloud@strettch.com

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.

SC Compute

DNS

Teams

Agents

Automatic Installation

Manual Installation

Quick Install (Recommended)

Review Before Installing

Verify Installation

Managing the Agent

Basic Commands

Auto-Start on Boot

Viewing Logs

Updates

Uninstalling

Troubleshooting

Console Not Accessible?

Step 1: SSH into Your Virtual Machine

Step 2: Verify Required Ports are Open

Step 3: Check if the Agent is Running

Step 4: Take Action Based on Status

Step 5: Test Console Access

Still Not Working?

Security

​Automatic Installation

​Manual Installation

​Quick Install (Recommended)

​Review Before Installing

​Verify Installation

​Managing the Agent

​Basic Commands

​Auto-Start on Boot

​Viewing Logs

​Updates

​Uninstalling

​Troubleshooting

​Console Not Accessible?

​Step 1: SSH into Your Virtual Machine

​Step 2: Verify Required Ports are Open

​Step 3: Check if the Agent is Running

​Step 4: Take Action Based on Status

​Step 5: Test Console Access

​Still Not Working?

​Security

Automatic Installation

Manual Installation

Quick Install (Recommended)

Review Before Installing

Verify Installation

Managing the Agent

Basic Commands

Auto-Start on Boot

Viewing Logs

Updates

Uninstalling

Troubleshooting

Console Not Accessible?

Step 1: SSH into Your Virtual Machine

Step 2: Verify Required Ports are Open

Step 3: Check if the Agent is Running

Step 4: Take Action Based on Status

Step 5: Test Console Access

Still Not Working?

Security