This is the official Wild Cloud apps repository containing a curated collection of self-hosted applications that can be deployed to your Wild Cloud cluster.

What are Wild Cloud Apps?

Wild Cloud apps are pre-packaged Kubernetes applications using Kustomize that follow standardized conventions for configuration, secrets management, and deployment. Each app includes:

App manifest (manifest.yaml) - Metadata, dependencies, and default configuration
Kustomization (kustomization.yaml) - Kubernetes resource definitions
Configuration templates - Deployments, services, ingresses, and other resources

Apps use gomplate templates that compile with your Wild Cloud configuration when added, making them easy to customize while maintaining a consistent deployment experience.

Using Wild Cloud Apps

Commands

Run these commands from your Wild Cloud home directory:

wild-apps-list - Browse all available apps in the repository
wild-app-add <app-name> - Add an app to your cluster:
- Copies the app manifest to your apps directory
- Adds default configuration to your config.yaml
- Generates required secrets in your secrets.yaml
- Compiles templates with your configuration
wild-app-deploy <app-name> - Deploy or update the app in your cluster

How It Works

Add an app: wild-app-add compiles the app's templates using your Wild Cloud configuration (domain, email, etc.) and creates standard Kustomize files in your Wild Cloud home directory
Customize (optional): Modify the compiled files in your home directory, or use Kustomize patches/overlays
Deploy: wild-app-deploy applies the Kustomize configuration to your cluster
Manage: Track changes with Git, update configurations as needed

Dependencies

Some apps require other apps to function. For example:

Immich requires PostgreSQL and Redis
OpenProject requires PostgreSQL and Memcached
Gitea requires PostgreSQL

When you add an app, check its requires field in the manifest and ensure dependencies are added first.

Available Apps

This repository includes apps for:

Content management (Ghost, Discourse)
Project management (OpenProject)
Photo management (Immich)
Code hosting (Gitea)
Email marketing (Listmonk, Keila)
AI interfaces (Open WebUI, vLLM)
Databases (PostgreSQL, MySQL, Redis, Memcached)
And more...

Run wild-apps-list to see the full catalog with descriptions.

Contributing

Want to add a new app or improve an existing one? See ADDING-APPS.md for detailed guidance on creating Wild Cloud apps.

Contributions are welcome via pull requests. Ensure your app follows the Wild Cloud conventions and includes all required files.

Notice: Third-Party Software

The Kubernetes manifests and Kustomize files in this directory are designed to deploy third-party software.

Unless otherwise stated, the software deployed by these manifests is not authored or maintained by this project. All copyrights, licenses, and responsibilities for that software remain with the respective upstream authors.

These files are provided solely for convenience and automation. Users are responsible for reviewing and complying with the licenses of the software they deploy.

This project is licensed under the GNU AGPLv3 or later, but this license does not apply to the third-party software being deployed.

See individual deployment directories for upstream project links and container sources.