sysutils/py-overlord 0.26.1 FreeBSD

Deploy FreeBSD jails as fast as you code

System: FreeBSD
Repository: FreeBSD ports
Maintainer: [email protected]
Last update: 2026-09-03
Commit: 75da1c9749
License: BSD3CLAUSE
Categories: sysutils, python
Package size: 237.9 KiB, 1845.5 KiB installed

Description

Overlord is a fast, distributed orchestrator for FreeBSD jails oriented to GitOps. You define a file with the service intended to run on your cluster and deployment takes seconds to minutes.

Install

Binary package:

pkg install py312-overlord

From the ports tree:

cd /usr/ports/sysutils/py-overlord/ && make install clean

To depend on this port in another port's Makefile:

RUN_DEPENDS=	py312-overlord>0:sysutils/py-overlord

Packages

The version each package repository carries. “-” means the repository builds no package of it, “n/a” that there is no such repository.

Repository	aarch64	amd64	armv6	armv7	i386
FreeBSD:14:latest	0.26.1	0.26.1	-	0.16.0	0.26.1
FreeBSD:14:quarterly	0.26.1	0.26.1	n/a	0.12.2	0.26.1
FreeBSD:15:latest	0.26.1	0.26.1	n/a	-	0.16.0
FreeBSD:15:quarterly	0.26.1	0.26.1	n/a	n/a	n/a
FreeBSD:16:latest	0.26.1	0.26.1	n/a	n/a	n/a
FreeBSD:16:quarterly	n/a	n/a	n/a	n/a	n/a

Dependencies

As this port's Makefile names them.

Runtime 21

${PYTHON_PKGNAMEPREFIX}aiofiles>=0 : devel/py-aiofiles
${PYTHON_PKGNAMEPREFIX}aiostalk>=0 : net/py-aiostalk
${PYTHON_PKGNAMEPREFIX}asciitree>=0 : graphics/py-asciitree
${PYTHON_PKGNAMEPREFIX}click>=0 : devel/py-click
${PYTHON_PKGNAMEPREFIX}dnspython>=0 : dns/py-dnspython
${PYTHON_PKGNAMEPREFIX}etcd3gw>=0 : devel/py-etcd3gw
${PYTHON_PKGNAMEPREFIX}httpx-retries>=0 : www/py-httpx-retries
${PYTHON_PKGNAMEPREFIX}humanfriendly>=0 : textproc/py-humanfriendly
${PYTHON_PKGNAMEPREFIX}ifaddr>=0 : net/py-ifaddr
${PYTHON_PKGNAMEPREFIX}mako>=0 : textproc/py-mako
${PYTHON_PKGNAMEPREFIX}psutil>=0 : sysutils/py-psutil
${PYTHON_PKGNAMEPREFIX}pyaml-env>=0 : devel/py-pyaml-env
${PYTHON_PKGNAMEPREFIX}pyjwt>=0 : www/py-pyjwt
${PYTHON_PKGNAMEPREFIX}pymemcache>=0 : databases/py-pymemcache
${PYTHON_PKGNAMEPREFIX}python-dotenv>=0 : www/py-python-dotenv
${PYTHON_PKGNAMEPREFIX}pyyaml>=0 : devel/py-pyyaml
${PYTHON_PKGNAMEPREFIX}supervisor>=0 : sysutils/py-supervisor
${PYTHON_PKGNAMEPREFIX}sysctl>=0 : devel/py-sysctl
${PYTHON_PKGNAMEPREFIX}tornado>=0 : www/py-tornado
beanstalkd>=0 : net/beanstalkd
memcached>=0 : databases/memcached

The full lists below include those, and their dependencies in turn.

Build dependencies 11

Run dependencies 68

No port depends on this one.

Configuration

Options name: sysutils_overlord

Option

Default

Description

DOCS

off

Build and/or install documentation

USES: python
Service scripts: none

Message after installing

The configuration file can be found at the following path:
  /usr/local/etc/overlord.yml
Edit it to suit your needs before starting the Overlord services.

1. If you have configured Overlord to use Beanstalkd and Memcache locally (by default),
   you need to start those services.

   - enable required services:
     # sysrc beanstalkd_enable=YES
     # sysrc memcached_enable=YES

   - start required services:
     # service beanstalkd start
     # service memcached start

2. If you have not installed Director or AppJail from the development repository and
   prefer to install them from precompiled binaries:

   - install Director:
     # pkg install py312-director

   - install AppJail:
     # pkg install -y appjail # or appjail-devel

3. Set up supervisord in order to execute Overlord services:
  - Some processes may rely on the assumption that rctl(4) is enabled, if it is not
    already enabled, please enable it by adding to /boot/loader.conf:
kern.racct.enable=1

    Remember to reboot for the above change take effect.

  - let supervisord.conf load files contained in this directory by adding to
    /usr/local/etc/supervisord.conf:
[include]
files = /usr/local/share/overlord/overlord.ini

  - enable supervisord:
    # sysrc supervisord_enable=YES

  - start supervisord:
    # service supervisord start

4. Enjoy.

Files

Manual pages 2

overlord(1)
overlord-spec(5)

pkg-plist 142

@sample(root,wheel,0640) etc/overlord.yml.sample
@dir /var/log/overlord
libexec/overlord/safe-exc.sh
libexec/overlord/vm-install-from-appjail-image.sh
libexec/overlord/vm-install-from-components.sh
libexec/overlord/vm-install-from-pkgbase.sh
libexec/overlord/vm-start.sh
libexec/overlord/create.py
share/man/man1/overlord.1.gz
share/man/man5/overlord-spec.5.gz
share/py312-overlord/overlord.ini
bin/overlord
%%PYTHON_SITELIBDIR%%/overlord/__init__.py
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/__init__.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/__init__.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/cache.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/cache.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/chains.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/chains.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/client.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/client.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/config.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/config.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/dataplaneapi.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/dataplaneapi.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/default.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/default.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/director.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/director.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/environment.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/environment.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/error.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/error.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/etcd.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/etcd.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/exceptions.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/exceptions.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/jail.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/jail.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/jwt.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/jwt.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/metadata.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/metadata.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/process.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/process.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/queue.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/queue.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/signals.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/signals.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/skydns.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/skydns.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/sysexits.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/sysexits.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/tornado.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/tornado.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/trap.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/trap.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/util.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/util.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/version.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/version.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/vm.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/__pycache__/vm.pyc
%%PYTHON_SITELIBDIR%%/overlord/cache.py
%%PYTHON_SITELIBDIR%%/overlord/chains.py
%%PYTHON_SITELIBDIR%%/overlord/client.py
%%PYTHON_SITELIBDIR%%/overlord/commands/__init__.py
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/__init__.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/__init__.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/apply.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/apply.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/cancel.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/cancel.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/config.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/config.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/destroy.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/destroy.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/info.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/info.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/logs.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/logs.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/poll.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/poll.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/serve.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/serve.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/spec.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/spec.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/template.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/template.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/token.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/token.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/watch.opt-1.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/__pycache__/watch.pyc
%%PYTHON_SITELIBDIR%%/overlord/commands/apply.py
%%PYTHON_SITELIBDIR%%/overlord/commands/cancel.py
%%PYTHON_SITELIBDIR%%/overlord/commands/config.py
%%PYTHON_SITELIBDIR%%/overlord/commands/destroy.py
%%PYTHON_SITELIBDIR%%/overlord/commands/info.py
%%PYTHON_SITELIBDIR%%/overlord/commands/logs.py
%%PYTHON_SITELIBDIR%%/overlord/commands/poll.py

The first 100 are listed.

distinfo 1

File

Size

SHA256

DtxdF-overlord-v0.26.1_GH0.tar.gz

104597

dca88819a04e88bd509dc01a7423b7a57c58733ffb83318c6b6da9f05f31ba14

Commit history 2

Date Commit Credits Log message

2026-09-03

75da1c9749

Jesús Daniel Colmenares Oviedo

sysutils/py-overlord: Update to 0.26.1

ChangeLog: https://github.com/DtxdF/overlord/releases/tag/v0.26.1 MFH: 2026Q3

2026-09-03 633d490eeb Jesús Daniel Colmenares Oviedo sysutils/py-overlord: Fix file mode in etc/overlord.yml.sample