theo-agent installation¶

Download¶

1. Simply download one of the binaries for your system:¶

# Linux x86-64
sudo curl -L -o /usr/sbin/theo-agent https://github.com/theoapp/theo-agent/releases/download/$(curl -L -s -H 'Accept: application/json' https://github.com/theoapp/theo-agent/releases/latest |sed -e 's/.*"tag_name":"\([^"]*\)".*/\1/')/theo-agent-linux-amd64

# Linux arm
sudo curl -L -o /usr/sbin/theo-agent https://github.com/theoapp/theo-agent/releases/download/$(curl -L -s -H 'Accept: application/json' https://github.com/theoapp/theo-agent/releases/latest |sed -e 's/.*"tag_name":"\([^"]*\)".*/\1/')/theo-agent-linux-arm

2. Make it executable¶

sudo chmod 755 /usr/sbin/theo-agent

3. Create a Theo Agent user:¶

sudo useradd \
    --comment 'Theo Agent' \
    --shell /bin/false

4. Install¶

4.1. Full Automatic install¶

sudo theo-agent -install \
    -no-interactive \
    -sshd-config \
    -url ${THEO_URL} \
    -token ${THEO_CLIENT_TOKEN}

4.2. Semi-Automatic install¶

sudo theo-agent -install \
    -no-interactive \
    -url ${THEO_URL} \
    -token ${THEO_CLIENT_TOKEN}

Edit /etc/ssh/sshd_config as suggested

4.3. Semi-manual install¶

sudo theo-agent -install
Answer to the questions and edit /etc/ssh/sshd_config as suggested

4.4. Manual install¶

Create a config.yml file (default is /etc/theo-agent/config.yml):
url: THEO_URL
token: THEO_CLIENT_TOKEN
Create a cache directory (default is /var/cache/theo-agent):
mkdir /var/cache/theo-agent
chmod 755 /var/cache/theo-agent
Modify /etc/ssh/sshd_config (if you changed the default path, add the options to the command)
PasswordAuthentication no
AuthorizedKeysFile /var/cache/theo-agent/%u
AuthorizedKeysCommand /usr/sbin/theo-agent [-config-file /path/to/config.yml] [-cache-path /path/to/cache/dir]
AuthorizedKeysCommandUser theo-agent