Skip to main content

veltro-cli

Stdlib-only operator CLI for the Veltro suite. Every Veltro release publishes it at the release's version. Install a release with:

curl -fsSL https://raw.githubusercontent.com/veltrosecurity/veltro/vX.Y.Z/install.sh \
  | VELTRO_RELEASE=X.Y.Z sh -s -- --admin-email you@example.com

or pip install veltro-cli==X.Y.Z and veltro install --suite-version X.Y.Z. Leave the version out to take the newest release.

While the repositories are private, GitHub answers 404 without a token. Export VELTRO_GITHUB_TOKEN (GITHUB_TOKEN and GH_TOKEN work too) with a token that can read veltrosecurity/veltro, and fetch the script with it: curl -fsSL -H "Authorization: Bearer $VELTRO_GITHUB_TOKEN" …. install, upgrade and status then read releases through the GitHub API, and the token goes nowhere else. The images also need docker login ghcr.io with a read:packages token.

veltro install asks for the first admin's email (--admin-email skips the question and is required when there's no terminal). After the stack starts, the admin's one-time sign-in link is in veltro logs veltro, on the line starting First admin. For a locked-out admin, run veltro admin reset --email you@example.com to print a fresh link (--dry-run shows the Compose command it runs).

For an existing install with no bootstrap operator assignment, run veltro operator-assign --email you@example.com with an enabled suite admin's address. --dry-run checks email syntax and prints the Compose command. It doesn't check whether the account exists, is enabled, or is an admin. Re-running prints the existing operator's email without changing it. Identity delivers the assignment to VectorFlow automatically and retries until ACK; bootstrapOperator.status in the authenticated GET /api/suite/peer-reads response is ready when finished. For Helm, use kubectl -n <namespace> exec deploy/<release>-veltro-identity-server -- node operator-assign --email you@example.com.

Requires Python ≥ 3.10 and Docker Compose ≥ 2.20 on the host.

Metadata

Release files for veltro-cli 0.36.4

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for veltro-cli 0.36.4
File Size Uploaded
veltro_cli-0.36.4.tar.gz 100.0 kB Details

Built distribution (wheel)

Table of built distributions (wheels) for veltro-cli 0.36.4
File Interpreter ABI Platform
veltro_cli-0.36.4-py3-none-any.whl Python 3 none any Details

Total release size: 216.3 kB

Release files / veltro_cli-0.36.4.tar.gz

Download URL veltro_cli-0.36.4.tar.gz
Size 100.0 kB
Tags Source
SHA-256 checksum
How to use checksums
4108783a49606997d65c646778aea1ace402daf179b500551974b50855e4bee6
BLAKE2b-256 checksum
How to use checksums
a4252aa08f8fe62dc2c76c0f4ebfa6db757afdc4711788fa4108105515a9ee97
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.

Transparency log

Release files / veltro_cli-0.36.4-py3-none-any.whl

Download URL veltro_cli-0.36.4-py3-none-any.whl
Size 116.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
b22582510fed97df01c1b6dae59bd931991461f7341eddcd744e97fce14cc2a8
BLAKE2b-256 checksum
How to use checksums
971f52a139e78f0031e61d0d7c3b39fcea8889dab4ff51f80e75067f043d8bfe
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 17, 2026.

Transparency log

Release history Release notifications | RSS feed

0.36.9

2 release files

0.36.8

2 release files

0.36.7

2 release files

0.36.6

2 release files

This release

0.36.4 This release

2 release files

0.36.3

2 release files

0.35.4

2 release files

0.35.3

2 release files

0.35.2

2 release files

0.16.0

2 release files

0.15.9

2 release files

0.15.7

2 release files

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page