Download Epoch Agent

Install the agent on your servers to enable secure remote access. No inbound ports required.

Quickest Way

One-Line Install

Run this command in your terminal to automatically download and install the agent for your platform.

Terminal 
curl -sSL https://epochproxy.cloud/install.sh | bash

The installer auto-detects your OS and architecture. View install script source or download manually below.

Manual Download

Download the binary for your specific platform.

Detecting your platform...

Linux

x86_64 (Intel)

Download

Linux

ARM64 (Apple Silicon / ARM)

Download

macOS

x86_64 (Intel)

Download

macOS

ARM64 (Apple Silicon / ARM)

Download

Installation Steps

1

Download and Install

Use the one-line installer above, or download the binary manually and place it in your PATH: 

# Using the installer (recommended)
curl -sSL https://epochproxy.cloud/install.sh | bash

# Or manually (example for Linux x86_64)
curl -fsSL -o epoch-agent https://epochproxy.cloud/releases/v0.1.0/epoch-agent-linux-amd64
chmod +x epoch-agent
sudo mv epoch-agent /usr/local/bin/
2

Get Your Activation Code

Log in to the Epoch dashboard and create a new agent. You'll receive an activation code that looks like act_xxxxxxxxxxxx.

3

Activate the Agent

Run the agent with your activation code to register it with the Epoch service: 

epoch-agent --activation-code YOUR_ACTIVATION_CODE
4

Run as a Service (Recommended)

For production use, run the agent as a systemd service: 

# Create a systemd service file
sudo tee /etc/systemd/system/epoch-agent.service > /dev/null << 'EOF'
[Unit]
Description=Epoch Agent
After=network.target

[Service]
Type=simple
ExecStart=/usr/local/bin/epoch-agent
Restart=always
RestartSec=10

[Install]
WantedBy=multi-user.target
EOF

# Enable and start the service
sudo systemctl daemon-reload
sudo systemctl enable epoch-agent
sudo systemctl start epoch-agent

System Requirements

Linux

  • x86_64 or ARM64 architecture
  • Any modern Linux distribution (kernel 3.10+)
  • Static binary - no dependencies required

macOS

  • Intel (x86_64) or Apple Silicon (ARM64)
  • macOS 11 (Big Sur) or later
  • Rosetta 2 supported for Intel binaries

Network Requirements

The agent requires outbound HTTPS (port 443) access to connect to the Epoch relay servers. No inbound ports need to be opened.

Need help getting started?

Check out our documentation for detailed guides and troubleshooting.

View Documentation Sign Up Free