Connect your servers

Install the outbound-only agent on a Linux host.

The agent polls StrataCore over HTTPS and executes jobs such as preview deploys and drift scans. It opens no inbound port, except the optional preview proxy you turn on yourself. On Kubernetes, see the Kubernetes page instead.

Requirements

  • Linux with systemd
  • Node.js 18 or newer
  • Docker; for built-in preview environments also the Docker Compose plugin and git
  • Outbound HTTPS to your StrataCore domain

Install

  1. Open Security, then Access, and choose Create agent token. Copy the token; it is shown once.
  2. Run the one-line command from the dialog on your server as root.
  3. Return to the console. The agent status in the sidebar turns green within a minute.
curl -fsSL https://YOUR_DOMAIN/agent/install.sh | sudo STRATACORE_ORG_TOKEN=sc_xxx STRATACORE_API_URL=https://YOUR_DOMAIN bash

Add --with-proxy (after bash -s --) to enable the built-in preview proxy; see GitHub pull-request previews.

Integrity

To pin the exact agent file, set STRATACORE_AGENT_SHA256 to the checksum published with the agent release; the installer refuses a file that does not match.

Troubleshooting

  • Check the service: systemctl status stratacore-agent
  • Read logs: journalctl -u stratacore-agent -f
  • A revoked token stops working immediately. Create a new one and re-run the installer.
  • A job that failed shows the agent error in the audit log.

Uninstall

sudo systemctl disable --now stratacore-agent
sudo rm -f /etc/systemd/system/stratacore-agent.service
sudo rm -rf /opt/stratacore /etc/stratacore /var/lib/stratacore
sudo systemctl daemon-reload

Then revoke the token under Security, Access. Containers the agent started for previews are not removed by uninstalling; destroy the previews in the console first.

Connect your servers | StrataCore Docs