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.7

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.7
File Size Uploaded
veltro_cli-0.36.7.tar.gz 100.0 kB Details

Built distribution (wheel)

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

Total release size: 216.3 kB

Release files / veltro_cli-0.36.7.tar.gz

Download URL veltro_cli-0.36.7.tar.gz
Size 100.0 kB
Tags Source
SHA-256 checksum
How to use checksums
508fa5d53e7383c8b13761c41535f7db2b81bb8d1da0a8b0350fceaeab845d60
BLAKE2b-256 checksum
How to use checksums
31e37dfbd6fd86df9e7f0695da1f1821d219f808e016d9ad9bbf7193b68247c2
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.7-py3-none-any.whl

Download URL veltro_cli-0.36.7-py3-none-any.whl
Size 116.3 kB
Tags Python 3
SHA-256 checksum
How to use checksums
0100612b07216ce1437d1d0a535d44f5761e64fec05c7244ed4db35fc59842fb
BLAKE2b-256 checksum
How to use checksums
a1ac950e142e05a1dd9cddcb3bdfcee973a54290c6ac0f43f2df1bf270bcf147
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

This release

0.36.7 This release

2 release files

0.36.6

2 release files

0.36.4

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