# linuxserver/docker-mods

Documentation and Examples of base container modifications

Repository: https://github.com/linuxserver/docker-mods
Canonical: https://ross.abutalabs.com/products/docker-mods
License: GPL-3.0
License Family: copyleft
Topics: hacktoberfest
Last push: 2026-08-16T20:51:02+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 35, longevity 100
- inputs: {"age_days": 2699, "days_push": 17, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1536, forks 329 (observed 2026-08-28T04:04:59.947575+00:00)

## What it is
Documentation and examples for LinuxServer.io's Docker Mods system, which lets users layer modifications onto base containers via tarballs pulled from Docker Hub or GitHub Container Registry at boot. Mods are applied by setting the DOCKER_MODS environment variable, avoiding the need to fork the original container repositories.

## Use cases
- customize a linuxserver docker container without forking it
- inject extra packages into a container at startup
- share container modifications with the community
- hook containers together with environment variables in compose
- apply multiple mods to a single docker container

## When to choose
- you use LinuxServer.io containers and need small customizations without maintaining a fork
- you want to distribute a container tweak as a lightweight mod layer
- you need to chain configuration between LSIO containers via compose env vars

## When to avoid
- you need strict security guarantees - third-party mods run arbitrary code in your container
- you want official LinuxServer support, which is voided when mods are active
- you need deep changes better handled by building your own image

## Facets
- artifact type: infra-config
- maturity: active
- function: configuration-management, container-runtime, deployment, developer-tools
- domain: self-hosted, documentation
- platform: self-hosted
- tags: docker-mods, linuxserver-io, container-modification, docker-hub, ghcr, containers, devops, docker, linux

## Member repositories
- linuxserver/docker-mods (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:59.947575+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:31:05.272737+00:00, confidence not recorded.
  - readme: https://github.com/linuxserver/docker-mods (fetched 2026-08-28T04:04:59.947575+00:00, sha 8c5287fabf24)
- Data as of 2026-08-30T08:39:29.467469+00:00.