Manual installation (without the one-line installer)

For administrators who prefer to see and run every step on Linux or macOS. The result is identical to the one-line installer. On Windows, use the Windows installer (install.ps1, see the onboarding guide): it does not use Docker, and you can read it before running it with irm https://get.vrymdor.com/install.ps1 -OutFile install.ps1 and check it against SHA256SUMS.

1. Check the prerequisites

docker version            # Docker Engine 20.10 or newer
docker compose version    # Docker Compose v2

2. Download and verify the bundle

sudo mkdir -p /opt/vrymdor && sudo chown "$(id -u):$(id -g)" /opt/vrymdor   # macOS: mkdir -p ~/.vrymdor
cd /opt/vrymdor
curl -fsSLO https://get.vrymdor.com/vrymdor-connector-bundle.tar.gz
curl -fsSLO https://get.vrymdor.com/SHA256SUMS
grep vrymdor-connector-bundle.tar.gz SHA256SUMS | sha256sum -c -   # macOS: shasum -a 256 -c
tar -xzf vrymdor-connector-bundle.tar.gz

3. Create your settings file

cp .env.example .env
chmod 600 .env

Edit .env and set:

Setting	Value
`AWARENESS_TOKEN`	The token from your approval email (starts with `vrym_live_`)
`NODE_LABEL`	How this server appears in your dashboard, for example `web-01`. The same token works on every server you protect; give each server its own name
`HOST_OS_FAMILY`	`linux` or `macos`
`HOST_ARCH`	`x86_64` or `arm64`
`HOST_LOG_DIR`	`/var/log` on Linux. On macOS, an empty folder such as `~/.vrymdor/hostlog`
`HOST_LOG_GID`	The group that owns your auth log: `stat -c %g /var/log/auth.log` (Debian and Ubuntu) or `0` (RHEL, which uses `/var/log/secure`)

4. Start

mkdir -p data models
docker compose up -d --build

5. Verify

docker compose ps
docker compose logs -f connector     # look for: handshake ok

Your server appears in your Vrymdor dashboard within a minute. To upgrade later, download the new bundle, extract it over the same directory (your .env is not part of the bundle), and run docker compose up -d --build again.