Deploy target

Argent on Docker Compose

Install Argent Strategic Intelligence on one Linux server from a single bundle. A host check verifies the box and, with cosign installed, every Nyedis image signature; secrets are made on the server, and there is no repository to clone.

Docker logo
01 / DEPLOY TARGET

What Argent does with Docker Compose

Docker describes Compose as "a tool for defining and running multi-container applications." Argent ships one Compose bundle for a single Linux server. Source: Docker.

Argent Strategic Intelligence is the gateway between your AI agents and the AI models they use. The single-server bundle runs all of it on one host, for a pilot or a single-host site.

  • No repository to clone. A customer installs from one tarball.
  • The same signed release. The bundle is the Compose form of the same signed release the Helm chart installs, with every image pinned by digest.
  • Fast to stand up. On one cloud server the bundle was serving 100 seconds after unpacking, with images already in a private registry.
02 / DEPLOY TARGET

What is in the bundle

Three things, and the files the services need:

PartWhat it does
The Compose fileThe release's services, every image pinned by digest. A fresh copy is made from the release on every run, so an old copy never wins over the release being installed.
`preflight.sh`Checks the host and every image before anything starts, and ends in PREFLIGHT OK or PREFLIGHT FAILED.
`gen-secrets.sh`Makes this install's own secrets and certificates on the server.

Add-ons are your choice. The optional add-on services in the release arrive switched off; an operator turns each on.

03 / DEPLOY TARGET

What the host check proves

`preflight.sh` prints one line per check and stops the install on any failure.

  1. The host. Processor count, memory, free disk and chip architecture.
  2. Docker. Docker Engine 24 or newer and the Compose v2 plugin.
  3. Secrets. Runs gen-secrets.sh: secrets are generated for this install, written to a file only its owner can read, never printed, and kept on a re-run.
  4. Ports. Every port the services publish is free.
  5. Images. Each image resolves at its pinned digest, and, with cosign installed, each Nyedis image's signature is checked against the Nyedis key shipped in the bundle.

Any failure prints FAIL with the reason, and the run ends in PREFLIGHT FAILED. Only a clean run ends in PREFLIGHT OK.

04 / DEPLOY TARGET

What you provide

A Linux server and a registry it can reach.

  • One Linux host with Docker Engine 24 or newer and Compose v2, on amd64 or arm64.
  • cosign on the host, so the host check verifies every Nyedis image signature.
  • Image access. Pull from the Nyedis registry, or set ARGENT_REGISTRY to your own mirror. The host check then rewrites every image to the mirror and keeps the untouched release file beside it.
  • Models to route to. Outside providers you approve, such as OpenAI, Anthropic or Amazon Bedrock, or a local engine such as Ollama, vLLM or LM Studio, each turned on by an admin.
  • Your identity and keys, when ready. People sign in through your directory and AI keys can stay in your vault.
05 / DEPLOY TARGET

Updates, the same way

An update is the next bundle, unpacked over the install.

  • The host check runs again. It rebuilds the Compose file from the new release, never from the old one, and checks every image again.
  • The database migrates itself on start.
  • Your secrets stay. gen-secrets.sh keeps what it made the first time.

Growing past one server? The Helm chart installs the same signed release on a cluster, with more gateway copies as demand grows. For a sealed network, carry the release in as the air-gapped bundle.

06 / DEPLOY TARGET

Where it fits, and how you start

The single-server bundle suits a pilot, a lab, or a site that runs on one host.

  1. Unpack. Copy the bundle to the server and unpack it.
  2. Check. Run preflight.sh until it ends in PREFLIGHT OK.
  3. Start, then watch. Bring the stack up, point one agent at the gateway, and run in Watch mode before you enforce. Take the walkthrough.
Cloud and deploy targets

Argent runs in each of these, and checks the three clouds for ways around the gateway.

  • Amazon Web Services
  • Microsoft Azure
  • Google Cloud
  • Kubernetes and Helm
  • Docker Compose
  • Air-gapped install