Using License Filters on the Orivana Catalog
Published 2026-06-27 · Updated 2026-08-21 · 12 min read · By Ben Liu
Catalog workflow only: combine SPDX-style filters with Docker/language filters, then verify upstream LICENSE files — not a second license primer.
Scope of this page
This is the **directory filter workflow**. License concepts (MIT/GPL/AGPL meanings) live in Open-source licenses quick guide. Do not treat badges as compliance verdicts.
Filters narrow; LICENSE files decide
Orivana filters mirror SPDX labels when upstream is clear. Dual-license, open-core, and "enterprise module" cases still need human reading of LICENSE/NOTICE.
Personal vs product threshold
Before pinning an image, answer:
- Redistribute outside the household?
- Modify sources and expose publicly?
- Any network-copyleft dependency?
- Need patent peace for a future commercial fork?
All "personal / unmodified / private" → many licenses are low friction. One "yes" to redistribution changes the worksheet.
Deliberate Orivana workflow
- Apply license filter(s) that match your redistribution plan.
- Combine with Docker / language filters → shortlist 5–10.
- Open each survivor's upstream LICENSE + NOTICE (and release notes for license changes).
- Scan the **pinned** image SBOM if you ship or redistribute containers.
- Record the decision in STACK.md next to compose.
syft docker.io/example/app:1.2.3 -o spdx-json > app.spdx.json
rg -i "GPL|AGPL|Apache|MIT" app.spdx.json | headCommon filter mistakes
- Badge without version (license changed at 2.0)
- Monorepo: server GPL / client MIT — know what you ship
- Open-core extras under commercial terms
- Trusting Docker Hub blurbs over GitHub LICENSE
Pair with other shortlist columns
License is one column beside Docker support, backup story, and maintainer activity — see How to choose your first stack.
Related reading
See Open-source licenses quick guide and Cost of self-hosting.
Explore more
Related guides
- Family Handoff Docs: Keep the Homelab Alive Without You
Write a one-hour handoff pack so a partner or friend can restart services, restore from backup, and contact you with useful facts.
- VPS vs Home Lab: Which Host Belongs Where?
A calm comparison of cost, latency, power, and blast radius for common self-hosted workloads.
- Open-Source Licenses: Concepts Operators Need
MIT, Apache-2.0, GPL, and AGPL in plain language for people who deploy software — concepts only. Catalog filter workflow lives on a separate guide.
- The Real Cost of Self-Hosting: Money, Time, and Attention
Line-item costs beyond hardware: power, disks, domains, backups, failure time, and when SaaS is cheaper in attention.