Skip to content

Linux Installation

Quick Install

The fastest way to install on Linux:

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

Supported Platforms

Architecture	Binary
x86_64 (AMD64)	`epoch-agent-linux-amd64`
ARM64 (aarch64)	`epoch-agent-linux-arm64`

Manual Installation

1. Download the Binary

Download the appropriate binary for your architecture:

# For x86_64
curl -LO https://epochproxy.cloud/releases/v0.1.0/epoch-agent-linux-amd64

# For ARM64
curl -LO https://epochproxy.cloud/releases/v0.1.0/epoch-agent-linux-arm64

2. Verify the Checksum (Recommended)

# Download the checksum file
curl -LO https://epochproxy.cloud/releases/v0.1.0/epoch-agent-linux-amd64.sha256

# Verify
sha256sum -c epoch-agent-linux-amd64.sha256

3. Install the Binary

# Make executable
chmod +x epoch-agent-linux-amd64

# Move to a directory in your PATH
sudo mv epoch-agent-linux-amd64 /usr/local/bin/epoch-agent

4. Verify Installation

epoch-agent --help

Installation Directories

The installer tries these locations in order:

~/.local/bin (if exists and writable)
/usr/local/bin (requires sudo)

To specify a custom location:

EPOCH_INSTALL_DIR=/opt/epoch curl -sSL https://epochproxy.cloud/install.sh | bash

Adding to PATH

If the installer warns that the directory is not in your PATH:

# For bash (~/.bashrc)
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.bashrc
source ~/.bashrc

# For zsh (~/.zshrc)
echo 'export PATH="$PATH:$HOME/.local/bin"' >> ~/.zshrc
source ~/.zshrc

Uninstalling

# If installed to user directory
rm ~/.local/bin/epoch-agent

# If installed system-wide
sudo rm /usr/local/bin/epoch-agent

# Remove state file
rm -rf ~/.config/epoch-agent

Next Steps