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

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. Legacy clients can continue to use https://artifact.websoft9.com/<channel>/websoft9/plugin/library/.

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

• Vision
• Architecture
• AI-SDLC Guide
• App owner contract
• Maintenance metadata
• Archive metadata
• Shared skills
• AI command manifest
• CLI
• Websoft9 Administrator Guide

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.