Skip to content
Projects

Websoft9/docker-library has 68 GitHub stars and 36 forks. GitHot measured 0 stars in 24 hours. Last checked 2026-11-16 04:23 UTC. Last push 2026-11-13.

How these counts are measured

Measured star growth

in 24h
0
in 7 days
Collecting history
in 15 days
Collecting history
in 1 month
Collecting history

Net star changes over overlapping periods, not daily totals. Missing measurements are left blank. Stars measure attention, not software quality.

About

100+ Docker Compose examples of selfhosted FOSS based on official image, just run it.

Self-hosted

README.md

Original

License: LGPL v3 GitHub last commit GitHub Release Date

Websoft9 Docker Library

This repository is the template library behind the Websoft9 App Store. It contains 100+ application packages built on Docker Compose, such as WordPress, MySQL, Odoo, MongoDB, GitLab, Grafana, n8n, Nextcloud, and ONLYOFFICE.

Each directory under apps/ is one independent deployment unit: a complete, versioned package that can be started with docker compose up, or deployed through the Websoft9 console.

Core design goals:

  • one app directory = one deployable unit
  • every app runs with docker compose up
  • consistent environment, network, and file conventions
  • machine-readable metadata for the Websoft9 platform and AI agents
  • repeatable, auditable maintenance

Quick start

AI agent deployment

Use the following prompt with your AI agent:

git colone https://github.com/Websoft9/docker-library.git, then deploy one app for me using the `install-app` skill.
Start by listing `apps/`, ask me which app to deploy if I did not specify one,
and return the final access URL plus a short validation summary.

Manual deployment

  1. Install Docker.

    curl -fsSL https://get.docker.com -o get-docker.sh && sh get-docker.sh
    sudo systemctl enable --now docker
    
  2. Clone this repository and list the available apps.

    git clone --depth=1 https://github.com/Websoft9/docker-library.git
    cd docker-library && ls apps
    
  3. Enter an app directory, review .env (at minimum set W9_POWER_PASSWORD), and start it.

    docker network create websoft9
    cd apps/wordpress
    sudo docker compose up -d
    

The Websoft9 console is the easiest way to run these packages with a web UI, domains, HTTPS, backups, and lifecycle management.

Artifacts

Published appstore artifacts are available at:

https://artifact.websoft9.com/appstore/release/manifests/appstore-manifest.json
https://artifact.websoft9.com/appstore/dev/manifests/appstore-manifest.json
https://artifact.websoft9.com/appstore/rc/manifests/appstore-manifest.json

The development app version index is also available at:

https://artifact.websoft9.com/appstore/dev/library/apps-verson.json

Each channel uses the same layout:

appstore/<channel>/
├── catalog/                 # catalog JSON files and manifest
├── library/
│   ├── apps/<app>/latest.zip
│   └── manifest.json
└── manifests/appstore-manifest.json

Start from appstore-manifest.json; it points to the catalog and library manifests. The publisher declares contracts and validates artifacts; each consumer independently decides whether it supports an update. Publication does not wait for consumer upgrades or approvals. Legacy library and media publication under https://artifact.websoft9.com/<channel>/websoft9/plugin/ is retired. Existing objects are left untouched, without maintenance or old-client compatibility guarantees; their verification is not a prerequisite for current publication. See consumer compatibility.

AI-driven maintenance

This repository is maintained by AI agents under owner review. The owner decides demand and the final end-to-end result; AI handles upstream research, implementation, routine validation, and reporting.

Entry points for contributors and agents:

  • AGENTS.md - repository rules and fastest entry point
  • docs/ai-sdlc/ - AI delivery pipeline, quality gates, and report format
  • skills/ - shared agent workflows for new apps, updates, deployment validation, and archive/restore
  • metadata/maintenance.yaml and metadata/archive.yaml - maintenance and lifecycle state
  • cli/ - the libs automation interface

AI agent commands (opencode)

Command adapters are generated from skills/commands.manifest.json by make build-ai-commands.

Command Purpose
/libs-install-app <app> [local|remote] Install one app package with target selection, port pre-check, and health validation
/libs-new-app <app> <trademark> <reference URL> Create a new app package
/libs-update-assessment <app> Check upstream versions and decide whether an update is worth doing
/libs-update-app <app> [version] Implement an approved update and produce a report
/libs-batch-update-app <selector> Update a batch of apps by name list or initials
/libs-deploy-validation <app> [local] Prove an app deploys and passes structure, policy, reachability, and log checks
/libs-release-readiness <app> Check whether a task is ready for owner E2E or release
/libs-test-report <app> <evidence source> Generate a report in the repository test-report format
/libs-catalog-seed <app> Create or update commercial catalog metadata and preview the Contentful push
/libs-archive-app <app> <reason> Archive one app or a small batch
/libs-restore-app <app> Restore an archived app to active maintenance

Where images come from

All images come from the official project or an authoritative third party (for example, Bitnami). Websoft9 does not maintain these images. Websoft9 verifies the upstream image and Compose configuration so that each package can run directly with docker compose up using the provided defaults.

Documentation

Contributing

Community contributions are welcome:

  1. Report bugs and propose features through issues.
  2. Read CONTRIBUTING.md and follow the AI-first delivery flow.
  3. Submit pull requests to the dev branch and include the latest test report.

Support

Websoft9 Enterprise Support covers knowledge, technical support (HTTPS, upgrades), and security services for production deployments.

License

LGPL-3.0. Additional terms: without authorization, it is not allowed to publish free or paid images based on this repository in any cloud platform's marketplace.

Disclaimer

We cannot guarantee that third-party open-source software is free of vulnerabilities or security risks. Assessing and accepting those risks is the responsibility of the user under the applicable open-source licenses.