github basnijholt/compose-farm v1.25.0

2 hours ago

Features

  • Install plugins from the config. List the packages that provide your plugins under the new top-level plugin_packages key, then run cf plugins install to install them into the Python environment that runs cf. This replaces the long uv tool install compose-farm --with "... @ git+...#subdirectory=..." command you had to repeat on every upgrade.

    plugin_packages:
      - github:basnijholt/compose-farm/examples/plugins/pin
      - github:basnijholt/compose-farm/examples/plugins/traefik-dns@v1.25.0
    plugins:
      pin:
        gitea: nas
    • Entries are pip requirements (PyPI names, git+https://... URLs, local paths relative to the config file), or the GitHub shorthand github:OWNER/REPO/SUBDIR@REF, where /SUBDIR and @REF are optional.
    • cf plugins install uses uv pip install when uv is on PATH and pip otherwise, then checks that the enabled plugins load and lists them.
    • uv tool upgrade compose-farm recreates the tool environment without the added packages. The next cf command then reports them as unknown, and cf plugins install restores them: uv tool upgrade compose-farm && cf plugins install.
    • The unknown-plugin error (CLI and web UI) now points to plugin_packages and cf plugins install.
    • The Docker image still bundles the example plugins; for other plugins, build your own image.

⚠️ Older releases reject the new plugin_packages key, so upgrade cf everywhere it reads the config, including the web UI container, before adding it.

Full changelog: v1.24.2...v1.25.0

Don't miss a new compose-farm release

NewReleases is sending notifications on new releases.