Skip to main content

FreeBSD jail provisioning tool

Project description

jprov

jprov is an opinionated FreeBSD jail provisioning tool designed for near-stateless jails. It rebuilds a jail from a template dataset, applies an overlay filesystem, mounts volumes, and runs a provisioning command inside the jail. It is intended to be used after system/template upgrades, not on every jail restart.

Status

Early development (pre-1.0). Expect breaking changes.

Requirements

  • FreeBSD with ZFS
  • Python 3.11+ (uses tomllib)
  • Root privileges (for zfs, jail, mount, jexec)

Install (uv)

uv pip install .

Usage

jprov [-y] [--dry-run] up <jailname>
jprov [-y] [--dry-run] down <jailname>

Configuration

See docs/CONFIG.md for the main config and per-jail TOML schema.

Logging

All command outputs are captured to a per-run log file. On fatal error, jprov prints:

script logs written to <logpath>.log

License

BSD-2-Clause

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

jprov-0.1.8.tar.gz (9.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

jprov-0.1.8-py3-none-any.whl (14.4 kB view details)

Uploaded Python 3

File details

Details for the file jprov-0.1.8.tar.gz.

File metadata

  • Download URL: jprov-0.1.8.tar.gz
  • Upload date:
  • Size: 9.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.3

File hashes

Hashes for jprov-0.1.8.tar.gz
Algorithm Hash digest
SHA256 4ca91e347a7d2470352890c714f2543067e2744ef67dfa3ea92098ed065d7e7f
MD5 c626cc105d7183b82190f61076536ce7
BLAKE2b-256 ef13776718ecc0c963b8e0215ad4900e9ca43d867cd44cfd29b53b087cda75dc

See more details on using hashes here.

File details

Details for the file jprov-0.1.8-py3-none-any.whl.

File metadata

  • Download URL: jprov-0.1.8-py3-none-any.whl
  • Upload date:
  • Size: 14.4 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: uv/0.7.3

File hashes

Hashes for jprov-0.1.8-py3-none-any.whl
Algorithm Hash digest
SHA256 aa1e32f0c969543b92b6235e253deec0b405212020c8428dd3461a17791370c2
MD5 20cd97cfd16186877e5f9024269fade7
BLAKE2b-256 4d90f6c5ace8e6a84be96629ea1ac8350341a3d939ae20b84cba0c032aefe232

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page