Compare commits

...

62 Commits

Author SHA1 Message Date
Paul Payne
763ac922d5 Add synapse federation Ingress for serverName path routing 2026-07-10 06:12:32 +00:00
Paul Payne
1b3200a5f1 Idempotent db-init passwords. 2026-07-10 05:14:24 +00:00
Paul Payne
dc5518b57f Externalize networking (welcome Wild Central!) 2026-07-10 03:49:38 +00:00
Paul Payne
bb5a76b864 Crowsec uses external LAPI. 2026-07-10 03:37:56 +00:00
Paul Payne
219a28bc65 Fixes synapse. 2026-07-10 03:36:15 +00:00
Paul Payne
387838819b Adds wild-directory server. 2026-07-10 03:35:56 +00:00
Paul Payne
c80d8dc411 Adds plausible. 2026-07-10 03:35:41 +00:00
Paul Payne
4d983819c9 feat(supabase): add services and statefulset for database management
feat(synapse): update ingress to use traefik ingress class and bump version

feat(syncthing-discovery): introduce syncthing discovery service with deployment and ingress

feat(syncthing-relay): add syncthing relay server with deployment and ingress configuration

fix(taiga): update liveness and readiness probes to use tcpSocket for health checks

fix(taiga): change PVC access mode to ReadWriteMany for media and static storage

feat(traefik): add icon and ignore rules for traefik service

docs(ushahidi): add notes for Redis configuration and Laravel startup probe adjustments

feat(ushahidi): implement dedicated Redis deployment for Ushahidi

fix(vllm): update deployment strategy and readiness/liveness probes for improved stability

fix(writefreely): pin writefreely image version to v0.15.1 for consistency

docs(zulip): add notes for TLS-terminating reverse proxy configuration and expected behavior
2026-07-02 21:34:27 +00:00
Paul Payne
9f5057dff8 feat(validation): add validation scripts for Wild Cloud app packages 2026-07-02 20:55:53 +00:00
Paul Payne
d9f10716b0 fix(pretix): increase memory limit to 6Gi; eventyay nginx sidecar; crowdsec middleware
pretix/standalone runs gunicorn + celery + celery-beat in one container
and OOMKilled at 4Gi. Increased limit to 6Gi, request to 512Mi.

eventyay: add nginx sidecar to serve static files, update health probes
to check a static asset at port 8080, add create-superuser script,
register script in manifest.

crowdsec: middleware fix (previously uncommitted).

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-22 04:20:40 +00:00
Paul Payne
74570413fc fix(karrot): fix nginx DNS resolver for Kubernetes and add README
The karrot-frontend nginx template hardcodes Docker's DNS resolver
(127.0.0.11) which doesn't exist in Kubernetes. Added a ConfigMap to
override the template, removing the Docker DNS resolver by using a
direct proxy_pass with no nginx variable (which would force runtime
resolution). Also adds a README with usage instructions.

Documents lessons learned in ADDING-APPS-NOTES.md:
- Note 24: nginx Docker DNS resolver doesn't work in Kubernetes; any
  nginx variable in proxy_pass (including $request_uri) forces runtime
  DNS resolution requiring a resolver directive
- Note 25: ConfigMap changes don't restart pods; subPath mounts never
  auto-update; always follow with kubectl rollout restart
- Note 26: includeSelectors mismatch affects every deployment in an
  app — check all endpoints, not just the web-facing one

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>
2026-06-22 04:08:04 +00:00
Paul Payne
7aa3e04829 Change aptly from service to app and update category handling in docs. 2026-06-20 21:45:39 +00:00
Paul Payne
368e3a8455 Adds app category labels. 2026-06-20 08:28:46 +00:00
Paul Payne
6e77c1ada5 Automatic GPG creation on aptly deployment. 2026-06-20 07:22:19 +00:00
Paul Payne
5c6f8f3a2b Removes manifest config for deprecated restore scenarios. 2026-06-20 06:40:14 +00:00
Paul Payne
dc54a10b51 Adds mysql to e2e test app. 2026-06-20 06:39:26 +00:00
Paul Payne
c223e2b5e0 Reduces apps default resource usage. 2026-06-19 21:38:56 +00:00
Paul Payne
63dcd1b82b Removes matrix app (renamed synapse) 2026-06-19 21:38:00 +00:00
Paul Payne
f445f50265 Adds mastodon app. 2026-06-19 21:37:06 +00:00
Paul Payne
0673442451 Adds loomio app. 2026-06-19 21:36:48 +00:00
Paul Payne
4d4b48cf72 Adds zulip app. 2026-06-19 21:33:33 +00:00
Paul Payne
cb5f3d66ff Adds writefreely app. 2026-06-19 21:33:33 +00:00
Paul Payne
be035c7a85 Adds wikijs app. 2026-06-19 21:33:33 +00:00
Paul Payne
0554916818 Adds vaultwarden app. 2026-06-19 21:33:30 +00:00
Paul Payne
2b1db70090 Adds ushahidi app. 2026-06-19 21:33:30 +00:00
Paul Payne
da8dfe9196 Adds umap app. 2026-06-19 21:33:30 +00:00
Paul Payne
0449272102 Adds typebot app. 2026-06-19 21:33:26 +00:00
Paul Payne
a2852dab0a Adds taiga app. 2026-06-19 21:33:26 +00:00
Paul Payne
1d57e26dae Adds synapse app. 2026-06-19 21:33:26 +00:00
Paul Payne
274d7a8fb9 Adds pretix app. 2026-06-19 21:33:23 +00:00
Paul Payne
cd37c07a33 Adds polis app. 2026-06-19 21:33:23 +00:00
Paul Payne
bd1116048d Adds pixelfed app. 2026-06-19 21:33:23 +00:00
Paul Payne
c2efed5937 Adds peertube app. 2026-06-19 21:33:20 +00:00
Paul Payne
424e57baec Adds outline app. 2026-06-19 21:33:20 +00:00
Paul Payne
b1295223b1 Adds ohmyform app. 2026-06-19 21:33:20 +00:00
Paul Payne
a3dafa925b Adds odoo app. 2026-06-19 21:33:17 +00:00
Paul Payne
8f8d3f7680 Adds nocodb app. 2026-06-19 21:33:17 +00:00
Paul Payne
110eca06ce Adds nextcloud app. 2026-06-19 21:33:17 +00:00
Paul Payne
5e98b3fce6 Adds moodle app. 2026-06-19 21:33:14 +00:00
Paul Payne
855fb03e17 Adds mobilizon app. 2026-06-19 21:33:14 +00:00
Paul Payne
a2e3031b84 Adds mediawiki app. 2026-06-19 21:33:14 +00:00
Paul Payne
2ebbc65dd3 Adds mautic app. 2026-06-19 21:33:11 +00:00
Paul Payne
2d0292a69b Adds mattermost app. 2026-06-19 21:33:11 +00:00
Paul Payne
d7a11b380c Adds limesurvey app. 2026-06-19 21:33:11 +00:00
Paul Payne
3e3b048f5b Adds librebooking app. 2026-06-19 21:33:08 +00:00
Paul Payne
347c4e0c90 Adds karrot app. 2026-06-19 21:33:08 +00:00
Paul Payne
413800cbcb Adds jitsi app. 2026-06-19 21:33:08 +00:00
Paul Payne
f9ef89f00d Adds indico app. 2026-06-19 21:33:05 +00:00
Paul Payne
761712ba71 Adds headscale app. 2026-06-19 21:33:05 +00:00
Paul Payne
777bab792c Adds gancio app. 2026-06-19 21:33:05 +00:00
Paul Payne
b42f048f5c Adds formbricks app. 2026-06-19 21:33:01 +00:00
Paul Payne
8a2539e527 Adds firefly-iii app. 2026-06-19 21:33:01 +00:00
Paul Payne
1d63970113 Adds eventyay app. 2026-06-19 21:33:01 +00:00
Paul Payne
a25366daf7 Adds etherpad app. 2026-06-19 21:32:58 +00:00
Paul Payne
aee2e93803 Adds cryptpad app. 2026-06-19 21:32:58 +00:00
Paul Payne
294cf59dd0 Adds chamilo app. 2026-06-19 21:32:58 +00:00
Paul Payne
7b41ed5148 Adds bookwyrm app. 2026-06-19 21:32:56 +00:00
Paul Payne
78ac8d0cbb Adds bookstack app. 2026-06-19 21:29:35 +00:00
Paul Payne
c2493dc58a Adds baserow app. 2026-06-19 21:29:25 +00:00
Paul Payne
b95586e74b Adds akaunting app. 2026-06-19 21:29:14 +00:00
Paul Payne
319ec01f0c Fix default ingress. 2026-06-08 17:10:46 +00:00
Paul Payne
4eb722f393 Aptly and community search. 2026-06-08 17:10:11 +00:00
679 changed files with 20599 additions and 1429 deletions

File diff suppressed because it is too large Load Diff

View File

@@ -1,5 +1,7 @@
- @README.md - @README.md
- @ADDING-APPS.md
- ADDING-APPS.md is the expert advice you need when adding new apps to the Wild Cloud Directory.
- docs/ contains deep-dive guides — runtime-specific (nodejs, python, php, ruby, jvm, nginx, linuxserver) and topic-specific (database, redis, traefik, scripts).
## Finding good sources of documentation for adding a new app to the Wild Cloud Directory ## Finding good sources of documentation for adding a new app to the Wild Cloud Directory

32
admin/scripts/validate-app.sh Executable file
View File

@@ -0,0 +1,32 @@
#!/usr/bin/env bash
# Validate a Wild Cloud app package before submitting.
#
# Usage:
# From your app directory: ../../admin/scripts/validate-app.sh
# From wild-directory root: admin/scripts/validate-app.sh <app-name>
set -euo pipefail
SCRIPT_DIR="$(cd "$(dirname "$0")" && pwd)"
WILD_DIR="$(cd "$SCRIPT_DIR/../.." && pwd)"
if [ $# -ge 1 ]; then
APP_NAME="$1"
else
CURRENT="$(pwd)"
if [[ "$CURRENT" == "$WILD_DIR"/* ]]; then
RELATIVE="${CURRENT#"$WILD_DIR"/}"
APP_NAME="${RELATIVE%%/*}"
else
echo "Usage: validate-app.sh <app-name>" >&2
echo " or run from inside your app directory." >&2
exit 1
fi
fi
if [ ! -d "$WILD_DIR/$APP_NAME" ]; then
echo "App not found: $APP_NAME" >&2
exit 1
fi
echo "Validating: $APP_NAME"
python3 "$SCRIPT_DIR/validate-apps.py" "$APP_NAME"

573
admin/scripts/validate-apps.py Executable file
View File

@@ -0,0 +1,573 @@
#!/usr/bin/env python3
"""Validate Wild Directory app packages for common authoring errors.
Usage:
python3 admin/scripts/validate-apps.py [app-name ...]
python3 admin/scripts/validate-apps.py --list-rules
With no arguments, validates all apps. Pass app names to check specific ones.
Exit code 1 if any errors are found.
To suppress specific rules for an app, add ignoreRules to its app.yaml:
ignoreRules:
- WC-HELM
- WC-SEL
"""
import os
import sys
import re
import yaml
REQUIRED_APP_YAML_FIELDS = ["name", "is", "description", "category", "latest"]
REQUIRED_MANIFEST_FIELDS = ["version"]
STANDARD_LABEL_PAIRS = {"managedBy": "kustomize", "partOf": "wild-cloud"}
HELM_LABELS = {"app.kubernetes.io/name", "app.kubernetes.io/instance", "app.kubernetes.io/component"}
MUTABLE_IMAGE_TAGS = {"latest", "main", "master", "edge", "develop", "dev", "nightly", "stable"}
GLOBAL_TEMPLATE_NAMESPACES = {"cloud", "cluster", "operator", "apps", "secrets", "app"}
def load_rules():
"""Load rule definitions from validation-rules.yaml in the same directory."""
script_dir = os.path.dirname(os.path.abspath(__file__))
rules_path = os.path.join(script_dir, "validation-rules.yaml")
with open(rules_path) as f:
data = yaml.safe_load(f)
rules = {}
remediation = {}
severity = {}
for rule_id, info in (data or {}).items():
if isinstance(info, dict):
rules[rule_id] = info.get("description", "")
severity[rule_id] = info.get("severity", "warning")
rem = info.get("remediation", "")
if rem:
remediation[rule_id] = rem.strip()
return rules, remediation, severity
RULES, REMEDIATION, SEVERITY = load_rules()
def add_error(errors, ignored_rules, rule_id, message):
if rule_id not in ignored_rules:
errors.append((rule_id, message))
def add_warning(warnings, ignored_rules, rule_id, message):
if rule_id not in ignored_rules:
warnings.append((rule_id, message))
def strip_gomplate(text):
"""Replace gomplate expressions with a placeholder so the file parses as valid YAML."""
return re.sub(r"\{\{.*?\}\}", "PLACEHOLDER", text, flags=re.DOTALL)
def load_yaml(path):
with open(path) as f:
content = f.read()
return yaml.safe_load(strip_gomplate(content))
def load_yaml_all(path):
"""Yield all YAML documents in a file (handles multi-doc files)."""
with open(path) as f:
content = f.read()
yield from yaml.safe_load_all(strip_gomplate(content))
def resource_docs(kustomize_dir, resources):
"""Yield (filepath, doc) for each YAML document in listed resource files."""
for resource in resources:
path = os.path.join(kustomize_dir, resource)
if not os.path.isfile(path):
continue
try:
for doc in load_yaml_all(path):
if doc:
yield path, doc
except Exception:
pass
def resources_have_workloads(kustomize_dir, resources):
"""Return True if any listed resource file contains a Deployment or StatefulSet."""
for _, doc in resource_docs(kustomize_dir, resources):
if doc.get("kind") in ("Deployment", "StatefulSet"):
return True
return False
def check_security_context(spec, resource_name, errors, warnings, ignored_rules):
"""Check pod-level and container-level security contexts."""
pod_spec = spec.get("template", {}).get("spec", {}) if "template" in spec else spec
if not pod_spec:
return
pod_sc = pod_spec.get("securityContext")
if not pod_sc:
add_warning(warnings, ignored_rules, "WC-SC-POD",
f"{resource_name}: no pod-level securityContext")
for container in pod_spec.get("containers", []) + pod_spec.get("initContainers", []):
cname = container.get("name", "?")
csc = container.get("securityContext")
if not csc:
add_warning(warnings, ignored_rules, "WC-SC-CTR",
f"{resource_name}/{cname}: no container-level securityContext")
def check_mysql_db_init(kustomize_dir, resources, errors, warnings, ignored_rules):
"""Check MySQL db-init SQL for the idempotent password pattern (WC-DBIN)."""
for resource in resources:
path = os.path.join(kustomize_dir, resource)
if not os.path.isfile(path):
continue
try:
with open(path) as f:
content = f.read()
except Exception:
continue
# Only files that contain MySQL-style SQL (IDENTIFIED BY is MySQL-specific)
if "CREATE USER" not in content or "IDENTIFIED BY" not in content:
continue
if "ALTER USER" not in content:
add_error(errors, ignored_rules, "WC-DBIN",
f"{os.path.basename(path)}: MySQL CREATE USER IF NOT EXISTS without ALTER USER"
" — passwords won't update on redeploy (see note #17)")
def check_docker_dns(kustomize_dir, resources, errors, warnings, ignored_rules):
"""Check for Docker DNS resolver (127.0.0.11) which doesn't work in Kubernetes (WC-DKRDNS)."""
for resource in resources:
path = os.path.join(kustomize_dir, resource)
if not os.path.isfile(path):
continue
try:
with open(path) as f:
content = f.read()
except Exception:
continue
if "127.0.0.11" in content:
add_error(errors, ignored_rules, "WC-DKRDNS",
f"{os.path.basename(path)}: contains Docker DNS resolver (127.0.0.11)"
" — use CoreDNS instead (see note #24)")
def check_resource_parse_errors(kustomize_dir, resources, errors, warnings, ignored_rules):
"""Check that all listed resource files parse as valid YAML (WC-RES-PARSE)."""
for resource in resources:
path = os.path.join(kustomize_dir, resource)
if not os.path.isfile(path):
continue # WC-RES already handles missing files
try:
list(load_yaml_all(path))
except Exception as e:
add_error(errors, ignored_rules, "WC-RES-PARSE",
f"{resource}: YAML parse error: {e}")
def check_namespace_resource(kustomize_dir, resources, errors, warnings, ignored_rules):
"""Check that a Namespace resource exists when workloads are present (WC-NSFILE)."""
if not resources_have_workloads(kustomize_dir, resources):
return
for _, doc in resource_docs(kustomize_dir, resources):
if doc.get("kind") == "Namespace":
return
add_warning(warnings, ignored_rules, "WC-NSFILE",
"no Namespace resource in kustomization.yaml — add namespace.yaml")
def check_template_vars(kustomize_dir, default_config, errors, warnings, ignored_rules):
"""Check top-level template variables in resource files against defaultConfig (WC-TVAR)."""
if not default_config:
return
defined_keys = set(default_config.keys())
for fname in sorted(os.listdir(kustomize_dir)):
if not fname.endswith(".yaml") or fname == "manifest.yaml":
continue
path = os.path.join(kustomize_dir, fname)
try:
with open(path) as f:
content = f.read()
except Exception:
continue
seen_undefined = set()
for block in re.finditer(r"\{\{-?\s*(.*?)\s*-?\}\}", content, re.DOTALL):
for m in re.finditer(r"(?<![.\w])\.([a-z]\w*)", block.group(1)):
var_name = m.group(1)
if var_name in GLOBAL_TEMPLATE_NAMESPACES:
continue
if var_name not in defined_keys and var_name not in seen_undefined:
seen_undefined.add(var_name)
add_warning(warnings, ignored_rules, "WC-TVAR",
f"{fname}: template variable .{var_name!r} not in defaultConfig")
def validate_resources(kustomize_dir, resources, errors, warnings, ignored_rules):
"""Run per-document checks on all resource files."""
rwo_pvc_names = set()
# First pass: collect RWO PVC claim names
for _, doc in resource_docs(kustomize_dir, resources):
if doc.get("kind") == "PersistentVolumeClaim":
access_modes = doc.get("spec", {}).get("accessModes", [])
if "ReadWriteOnce" in access_modes:
rwo_pvc_names.add(doc.get("metadata", {}).get("name", ""))
# Second pass: validate each document
for fpath, doc in resource_docs(kustomize_dir, resources):
fname = os.path.basename(fpath)
kind = doc.get("kind", "")
name = doc.get("metadata", {}).get("name", fname)
label_ref = f"{fname}:{name}"
if kind in ("Deployment", "StatefulSet", "DaemonSet"):
spec = doc.get("spec", {})
# Security context
check_security_context(spec, label_ref, errors, warnings, ignored_rules)
# RWO PVC → must use Recreate strategy
if kind == "Deployment":
volumes = spec.get("template", {}).get("spec", {}).get("volumes", [])
uses_rwo = any(
v.get("persistentVolumeClaim", {}).get("claimName") in rwo_pvc_names
for v in volumes
)
if uses_rwo:
strategy = spec.get("strategy", {}).get("type", "RollingUpdate")
if strategy != "Recreate":
add_error(errors, ignored_rules, "WC-RWO",
f"{label_ref}: ReadWriteOnce PVC requires strategy: Recreate (got {strategy!r})")
# No Helm-style labels in pod template
pod_labels = spec.get("template", {}).get("metadata", {}).get("labels", {}) or {}
for helm_label in HELM_LABELS:
if helm_label in pod_labels:
add_error(errors, ignored_rules, "WC-HELM",
f"{label_ref}: Helm-style label {helm_label!r} found — use simple component labels instead")
# Image tags and sources
pod_spec = spec.get("template", {}).get("spec", {}) or {}
for container in pod_spec.get("containers", []) + pod_spec.get("initContainers", []):
image = container.get("image", "")
cname = container.get("name", "?")
tag = image.split(":")[-1] if ":" in image else ""
if tag.lower() in MUTABLE_IMAGE_TAGS:
add_error(errors, ignored_rules, "WC-IMG",
f"{label_ref}/{cname}: image tag {tag!r} is mutable — use a specific version tag")
elif not tag:
add_warning(warnings, ignored_rules, "WC-IMG",
f"{label_ref}/{cname}: image has no tag — specify a version")
if re.search(r"(?:^|/)bitnami", image.split(":")[0]):
add_warning(warnings, ignored_rules, "WC-BITNAMI",
f"{label_ref}/{cname}: uses a Bitnami image ({image.split(':')[0]!r})"
" — prefer an official image")
elif kind == "Ingress":
annotations = doc.get("metadata", {}).get("annotations", {}) or {}
spec = doc.get("spec", {}) or {}
# Must use spec.ingressClassName, not annotation
if "kubernetes.io/ingress.class" in annotations:
add_error(errors, ignored_rules, "WC-ING-ANN",
f"{label_ref}: use spec.ingressClassName: traefik, not kubernetes.io/ingress.class annotation")
if spec.get("ingressClassName") != "traefik":
add_warning(warnings, ignored_rules, "WC-ING-CLS",
f"{label_ref}: spec.ingressClassName should be 'traefik' (got {spec.get('ingressClassName')!r})")
# No cert-manager annotation (wildcard cert is pre-distributed)
if "cert-manager.io/cluster-issuer" in annotations:
add_error(errors, ignored_rules, "WC-CERT",
f"{label_ref}: do not use cert-manager.io/cluster-issuer — wildcard TLS cert is pre-distributed to namespaces")
# External-dns target annotation
if "external-dns.alpha.kubernetes.io/target" not in annotations:
add_warning(warnings, ignored_rules, "WC-DNS",
f"{label_ref}: missing external-dns.alpha.kubernetes.io/target annotation")
def validate_kustomization(kustomize_dir, app_name, default_config, errors, warnings, ignored_rules):
path = os.path.join(kustomize_dir, "kustomization.yaml")
if not os.path.exists(path):
add_error(errors, ignored_rules, "WC-KUS-MISS", "MISSING kustomization.yaml")
return
try:
data = load_yaml(path)
except Exception as e:
add_error(errors, ignored_rules, "WC-KUS-PARSE", f"PARSE ERROR in kustomization.yaml: {e}")
return
if not data:
add_error(errors, ignored_rules, "WC-KUS-EMPTY", "EMPTY kustomization.yaml")
return
# Check all listed resources exist on disk
resources = data.get("resources") or []
for resource in resources:
resource_path = os.path.join(kustomize_dir, resource)
if not os.path.exists(resource_path):
add_error(errors, ignored_rules, "WC-RES", f"resource not found: {resource}")
has_workloads = resources_have_workloads(kustomize_dir, resources)
if has_workloads:
if "namespace" not in data:
add_warning(warnings, ignored_rules, "WC-NS",
"no namespace set in kustomization.yaml (has Deployment/StatefulSet)")
# Require includeSelectors: true
labels = data.get("labels") or []
include_selectors_entries = [
lbl for lbl in labels
if isinstance(lbl, dict) and lbl.get("includeSelectors") is True
]
if not include_selectors_entries:
add_error(errors, ignored_rules, "WC-SEL",
"labels.includeSelectors: true missing (required when Deployment/StatefulSet present)")
else:
pairs = include_selectors_entries[0].get("pairs") or {}
for key, expected in STANDARD_LABEL_PAIRS.items():
if pairs.get(key) != expected:
add_warning(warnings, ignored_rules, "WC-PAIRS",
f"label pair {key}: {expected!r} missing or wrong")
# app label should match the app directory name
if pairs.get("app") and pairs.get("app") != app_name:
add_warning(warnings, ignored_rules, "WC-LBL",
f"label pair app: {pairs['app']!r} doesn't match app directory name {app_name!r}")
# Per-resource checks
check_resource_parse_errors(kustomize_dir, resources, errors, warnings, ignored_rules)
validate_resources(kustomize_dir, resources, errors, warnings, ignored_rules)
check_mysql_db_init(kustomize_dir, resources, errors, warnings, ignored_rules)
check_docker_dns(kustomize_dir, resources, errors, warnings, ignored_rules)
check_namespace_resource(kustomize_dir, resources, errors, warnings, ignored_rules)
check_template_vars(kustomize_dir, default_config, errors, warnings, ignored_rules)
def validate_manifest(version_dir, errors, warnings, ignored_rules):
manifest_path = os.path.join(version_dir, "manifest.yaml")
if not os.path.exists(manifest_path):
add_error(errors, ignored_rules, "WC-MAN-MISS", "MISSING manifest.yaml")
return
try:
manifest = load_yaml(manifest_path)
except Exception as e:
add_error(errors, ignored_rules, "WC-MAN-PARSE", f"PARSE ERROR in manifest.yaml: {e}")
return
if not manifest:
add_error(errors, ignored_rules, "WC-MAN-EMPTY", "EMPTY manifest.yaml")
return
for field in REQUIRED_MANIFEST_FIELDS:
if field not in manifest:
add_error(errors, ignored_rules, "WC-MAN-REQ",
f"manifest.yaml missing field: {field}")
# defaultConfig should have a namespace field
default_config = manifest.get("defaultConfig") or {}
if not default_config:
add_warning(warnings, ignored_rules, "WC-CFG",
"manifest.yaml: defaultConfig is empty or missing")
elif "namespace" not in default_config:
add_warning(warnings, ignored_rules, "WC-CFG-NS",
"manifest.yaml: defaultConfig missing 'namespace' field")
# Check postgres dbUrl secrets contain ?sslmode=disable
for secret in manifest.get("defaultSecrets") or []:
if not isinstance(secret, dict):
continue
default = str(secret.get("default", ""))
if ("postgres" in default or "postgresql" in default) and "sslmode" not in default:
add_error(errors, ignored_rules, "WC-SSL",
f"manifest.yaml: defaultSecret {secret.get('key')!r} has postgres URL without ?sslmode=disable")
# requiredSecrets should use <app-ref>.<key> format
for rs in manifest.get("requiredSecrets") or []:
if isinstance(rs, str) and "." not in rs:
add_error(errors, ignored_rules, "WC-DOT",
f"manifest.yaml: requiredSecret {rs!r} missing dot notation (<app-ref>.<key>)")
def validate_version(version_dir, app_name, errors, warnings, ignored_rules):
validate_manifest(version_dir, errors, warnings, ignored_rules)
# Load defaultConfig for template variable checking
default_config = {}
manifest_path = os.path.join(version_dir, "manifest.yaml")
if os.path.exists(manifest_path):
try:
manifest_data = load_yaml(manifest_path) or {}
default_config = manifest_data.get("defaultConfig") or {}
except Exception:
pass
# Config-only apps (e.g. smtp) have no kubernetes resources — skip kustomization check
kustomize_path = os.path.join(version_dir, "kustomization.yaml")
resource_yamls = [
f for f in os.listdir(version_dir)
if f.endswith(".yaml") and f not in ("manifest.yaml", "kustomization.yaml")
]
if os.path.exists(kustomize_path) or resource_yamls:
validate_kustomization(version_dir, app_name, default_config, errors, warnings, ignored_rules)
def validate_app(app_dir):
errors = []
warnings = []
app_name = os.path.basename(app_dir)
app_yaml_path = os.path.join(app_dir, "app.yaml")
if not os.path.exists(app_yaml_path):
return [("WC-APP-MISS", "MISSING app.yaml")], []
try:
app_data = load_yaml(app_yaml_path)
except Exception as e:
return [("WC-APP-PARSE", f"PARSE ERROR in app.yaml: {e}")], []
if not app_data:
return [("WC-APP-EMPTY", "EMPTY app.yaml")], []
ignored_rules = set(app_data.get("ignoreRules") or [])
# Flag any ignoreRules entries that don't correspond to a known rule
for rule_id in ignored_rules:
if rule_id not in RULES:
errors.append(("WC-IGN", f"app.yaml ignoreRules contains unknown rule: {rule_id!r}"))
for field in REQUIRED_APP_YAML_FIELDS:
if not app_data.get(field):
add_error(errors, ignored_rules, "WC-REQ",
f"app.yaml missing required field: {field}")
# icon is cosmetic — warn rather than error
if not app_data.get("icon"):
add_warning(warnings, ignored_rules, "WC-ICON", "app.yaml missing field: icon")
# name must match directory name
if app_data.get("name") and app_data["name"] != app_name:
add_error(errors, ignored_rules, "WC-NAME",
f"app.yaml name {app_data['name']!r} doesn't match directory name {app_name!r}")
latest = str(app_data.get("latest", ""))
versions_dir = os.path.join(app_dir, "versions")
if not os.path.isdir(versions_dir):
add_error(errors, ignored_rules, "WC-VER", "MISSING versions/ directory")
return errors, warnings
# Check slot naming convention and validate each slot
for slot_name in sorted(os.listdir(versions_dir)):
slot_path = os.path.join(versions_dir, slot_name)
if not os.path.isdir(slot_path):
continue
# Flag full version strings (two or more dots) or packaging revision suffix (-N)
if re.search(r"\.\d+\.\d+", slot_name) or re.search(r"-\d+$", slot_name):
add_warning(warnings, ignored_rules, "WC-SLOT",
f"versions/{slot_name}: slot name looks like a full version or revision"
" — use the major version only (e.g. '1', 'v1')")
if latest:
latest_dir = os.path.join(versions_dir, latest)
if not os.path.isdir(latest_dir):
add_error(errors, ignored_rules, "WC-LATEST",
f"latest version directory not found: versions/{latest}")
else:
ver_errors, ver_warnings = [], []
validate_version(latest_dir, app_name, ver_errors, ver_warnings, ignored_rules)
errors.extend((rule_id, f"versions/{latest}: {msg}") for rule_id, msg in ver_errors)
warnings.extend((rule_id, f"versions/{latest}: {msg}") for rule_id, msg in ver_warnings)
# Check that upgrade waypoint slots exist
upgrade = app_data.get("upgrade") or {}
for rule in upgrade.get("from") or []:
via = rule.get("via")
if via:
via_dir = os.path.join(versions_dir, str(via))
if not os.path.isdir(via_dir):
add_error(errors, ignored_rules, "WC-VIA",
f"app.yaml upgrade.from[].via={via!r} references a non-existent slot")
return errors, warnings
def main():
args = sys.argv[1:]
if "--list-rules" in args:
print("Rule IDs for use in app.yaml ignoreRules:\n")
for rule_id in RULES:
sev = SEVERITY.get(rule_id, "warning")
print(f" {rule_id:<14} {sev:<8} {RULES[rule_id]}")
if rule_id in REMEDIATION:
lines = REMEDIATION[rule_id].split("\n")
print(f" {'':<14} Fix: {lines[0]}")
for line in lines[1:]:
print(f" {'':<14} {line}")
return 0
requested = [a for a in args if not a.startswith("--")]
wild_dir = os.path.dirname(os.path.dirname(os.path.dirname(os.path.abspath(__file__))))
if requested:
app_dirs = []
for name in requested:
path = os.path.join(wild_dir, name)
if not os.path.isdir(path):
print(f"ERROR: {name} not found in wild-directory", file=sys.stderr)
sys.exit(1)
app_dirs.append(path)
else:
app_dirs = sorted(
os.path.join(wild_dir, d)
for d in os.listdir(wild_dir)
if os.path.isdir(os.path.join(wild_dir, d))
and not d.startswith(".")
and os.path.exists(os.path.join(wild_dir, d, "app.yaml"))
)
total_errors = 0
total_warnings = 0
for app_dir in app_dirs:
app_name = os.path.basename(app_dir)
errors, warnings = validate_app(app_dir)
if errors or warnings:
print(f"\n{app_name}:")
shown_remediation = set()
for rule_id, msg in errors:
print(f" ERROR [{rule_id}] {msg}")
if rule_id in REMEDIATION and rule_id not in shown_remediation:
lines = REMEDIATION[rule_id].split("\n")
print(f" Fix: {lines[0]}")
for line in lines[1:]:
print(f" {line}")
shown_remediation.add(rule_id)
for rule_id, msg in warnings:
print(f" WARN [{rule_id}] {msg}")
if rule_id in REMEDIATION and rule_id not in shown_remediation:
lines = REMEDIATION[rule_id].split("\n")
print(f" Fix: {lines[0]}")
for line in lines[1:]:
print(f" {line}")
shown_remediation.add(rule_id)
total_errors += len(errors)
total_warnings += len(warnings)
print(f"\n{''*50}")
print(f"checked {len(app_dirs)} apps • {total_errors} errors • {total_warnings} warnings")
return 1 if total_errors > 0 else 0
if __name__ == "__main__":
sys.exit(main())

View File

@@ -0,0 +1,284 @@
# Wild Cloud App Validation Rules
#
# Loaded by validate-apps.py at runtime.
# Run `validate-apps.py --list-rules` for a formatted summary.
#
# To suppress a rule for an app, add its ID to ignoreRules in app.yaml:
# ignoreRules:
# - WC-HELM # upstream Helm-rendered manifests
#
# Fields:
# severity: error (must fix before submitting) | warning (strong suggestion)
# description: What the rule checks for
# remediation: How to fix the issue
# ── app.yaml ──────────────────────────────────────────────────────────────────
WC-APP-MISS:
severity: error
description: app.yaml file is missing
remediation: Create app.yaml with name, description, category, latest, and icon fields
WC-IGN:
severity: error
description: app.yaml ignoreRules contains an unknown rule ID
remediation: Remove the stale entry from ignoreRules, or check for a typo in the rule ID (run --list-rules to see valid IDs)
WC-APP-PARSE:
severity: error
description: app.yaml could not be parsed as valid YAML
remediation: Fix YAML syntax errors in app.yaml
WC-APP-EMPTY:
severity: error
description: app.yaml is empty
remediation: Populate app.yaml — it is empty
WC-REQ:
severity: error
description: app.yaml missing one or more required fields
remediation: "Add the missing fields: name, is, description, category, and latest are all required"
WC-NAME:
severity: error
description: app.yaml name does not match the directory name
remediation: "Set 'name:' in app.yaml to exactly match the directory name"
WC-ICON:
severity: warning
description: app.yaml missing icon field
remediation: "Add 'icon: <url>' to app.yaml pointing to the app's logo"
# ── versions ──────────────────────────────────────────────────────────────────
WC-VER:
severity: error
description: versions/ directory is missing
remediation: Create a versions/ subdirectory with at least one version slot directory inside it
WC-LATEST:
severity: error
description: latest version directory does not exist
remediation: "Create the version slot directory named in 'latest:', or update 'latest:' to an existing slot"
WC-VIA:
severity: error
description: upgrade.from[].via references a slot directory that does not exist
remediation: "Create the waypoint slot directory, or fix the via: value to match an existing slot"
WC-SLOT:
severity: warning
description: version slot directory name looks like a full version string or packaging revision
remediation: |
Rename the slot to the major version only (e.g. '1', 'v1', 'v0').
Full versions ('1.2.3') and packaging revisions ('1-2') do not belong in directory names.
The actual version string lives in manifest.yaml.
# ── manifest.yaml ─────────────────────────────────────────────────────────────
WC-NSFILE:
severity: warning
description: no Namespace resource defined — workloads will deploy into an unmanaged namespace
remediation: |
Add a namespace.yaml listing it in kustomization.yaml resources:
apiVersion: v1
kind: Namespace
metadata:
name: {{ .namespace }}
# ── manifest.yaml ─────────────────────────────────────────────────────────────
WC-MAN-MISS:
severity: error
description: manifest.yaml is missing
remediation: "Create manifest.yaml with at minimum: version, defaultConfig.namespace"
WC-MAN-PARSE:
severity: error
description: manifest.yaml could not be parsed
remediation: Fix YAML syntax errors in manifest.yaml
WC-MAN-EMPTY:
severity: error
description: manifest.yaml is empty
remediation: Populate manifest.yaml — it is empty
WC-MAN-REQ:
severity: error
description: manifest.yaml missing a required field
remediation: "Add the missing field to manifest.yaml (at minimum: version)"
WC-TVAR:
severity: warning
description: template variable in resource file not found in defaultConfig
remediation: |
Add the missing variable to defaultConfig in manifest.yaml, or check for a typo in the template.
Only top-level variable names are checked — e.g. .db in {{ .db.host }} must appear as a key under defaultConfig.
Global namespaces (cloud, cluster, operator, apps, secrets, app) are always available and exempt.
WC-CFG:
severity: warning
description: manifest.yaml defaultConfig is empty or missing
remediation: "Add a 'defaultConfig:' block to manifest.yaml"
WC-CFG-NS:
severity: warning
description: manifest.yaml defaultConfig missing namespace field
remediation: "Add 'namespace: <app-name>' under defaultConfig in manifest.yaml"
WC-SSL:
severity: error
description: postgres URL missing ?sslmode=disable
remediation: |
Append ?sslmode=disable to the postgres connection URL:
postgresql://user:pass@host:5432/db?sslmode=disable
WC-DOT:
severity: error
description: requiredSecret does not use <app-ref>.<key> dot notation
remediation: "Use <app-ref>.<key> format in requiredSecrets (e.g. postgres.password, not just 'password')"
# ── kustomization.yaml ────────────────────────────────────────────────────────
WC-KUS-MISS:
severity: error
description: kustomization.yaml is missing
remediation: Create kustomization.yaml listing all resource files with Wild Cloud labels
WC-KUS-PARSE:
severity: error
description: kustomization.yaml could not be parsed
remediation: Fix YAML syntax errors in kustomization.yaml
WC-KUS-EMPTY:
severity: error
description: kustomization.yaml is empty
remediation: "Add a resources: list and labels: block to kustomization.yaml"
WC-RES:
severity: error
description: a resource listed in kustomization.yaml does not exist on disk
remediation: "Create the missing file, or remove it from resources: in kustomization.yaml"
WC-RES-PARSE:
severity: error
description: a resource file listed in kustomization.yaml could not be parsed as valid YAML
remediation: Fix YAML syntax errors in the resource file
WC-NS:
severity: warning
description: no namespace in kustomization.yaml (has Deployment/StatefulSet)
remediation: "Add 'namespace: {{ .namespace }}' to kustomization.yaml"
WC-SEL:
severity: error
description: labels.includeSelectors true missing (required for Deployment/StatefulSet)
remediation: |
Add to kustomization.yaml:
labels:
- includeSelectors: true
pairs:
app: <app-name>
managedBy: kustomize
partOf: wild-cloud
WC-PAIRS:
severity: warning
description: a standard label pair is missing or has the wrong value
remediation: "Ensure labels.pairs includes managedBy: kustomize and partOf: wild-cloud"
WC-LBL:
severity: warning
description: label pair 'app' does not match the app directory name
remediation: "Set 'app:' in label pairs to match the app directory name"
# ── workloads ─────────────────────────────────────────────────────────────────
WC-SC-POD:
severity: warning
description: no pod-level securityContext defined
remediation: |
Add to the pod spec:
securityContext:
runAsNonRoot: true
runAsUser: <uid>
seccompProfile:
type: RuntimeDefault
WC-SC-CTR:
severity: warning
description: no container-level securityContext defined
remediation: |
Add to each container spec:
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop: [ALL]
WC-RWO:
severity: error
description: Deployment using a ReadWriteOnce PVC must use strategy Recreate
remediation: "Set strategy: type: Recreate on the Deployment — RWO volumes cannot attach to two pods at once"
WC-HELM:
severity: error
description: Helm-style app.kubernetes.io/* labels found in pod template
remediation: "Remove app.kubernetes.io/* labels from pod template; use simple labels (e.g. component: web) instead"
WC-IMG:
severity: error
description: container image uses a mutable or missing version tag
remediation: "Pin the image to a specific release tag (e.g. myimage:1.2.3), not latest/main/stable/etc."
WC-BITNAMI:
severity: warning
description: container image is from Bitnami — prefer an official image
remediation: |
Replace the Bitnami image with the official upstream image.
Bitnami images require Docker Hub authentication since 2023, use non-standard filesystem layouts,
and are often a sign of a Helm chart that wasn't fully adapted. Check Docker Hub or the project's
docs for the official image (e.g. postgres:15, redis:alpine, mariadb:11).
# ── ingress ───────────────────────────────────────────────────────────────────
WC-ING-ANN:
severity: error
description: ingress uses deprecated kubernetes.io/ingress.class annotation
remediation: "Replace the annotation with spec.ingressClassName: traefik in the Ingress spec"
WC-ING-CLS:
severity: warning
description: ingress spec.ingressClassName should be traefik
remediation: "Add 'ingressClassName: traefik' under spec: in the Ingress"
WC-CERT:
severity: error
description: ingress uses cert-manager annotation (wildcard cert is pre-distributed)
remediation: "Remove the cert-manager.io/cluster-issuer annotation — wildcard TLS is pre-distributed to namespaces"
WC-DNS:
severity: warning
description: ingress missing external-dns.alpha.kubernetes.io/target annotation
remediation: |
Add to Ingress metadata.annotations:
external-dns.alpha.kubernetes.io/target: '{{ .externalDnsDomain }}'
# ── db-init ───────────────────────────────────────────────────────────────────
WC-DKRDNS:
severity: error
description: Docker DNS resolver (127.0.0.11) used — not available in Kubernetes
remediation: |
Remove `resolver 127.0.0.11` and avoid nginx variables in proxy_pass.
Use `proxy_pass http://backend-name:port;` (no variable) so nginx resolves via CoreDNS at startup.
If a runtime-resolved variable is unavoidable, use the cluster DNS resolver instead:
resolver kube-dns.kube-system.svc.cluster.local valid=30s;
See docs/nginx.md for the full pattern.
WC-DBIN:
severity: error
description: MySQL db-init uses CREATE USER without ALTER USER (passwords won't update on redeploy)
remediation: |
Add ALTER USER after CREATE USER so passwords update on redeploy:
CREATE USER IF NOT EXISTS '${USER}'@'%' IDENTIFIED BY '${PASSWORD}';
ALTER USER '${USER}'@'%' IDENTIFIED BY '${PASSWORD}';

6
akaunting/app.yaml Normal file
View File

@@ -0,0 +1,6 @@
name: akaunting
is: akaunting
description: Akaunting is a free, open-source, and online accounting software for small businesses and freelancers.
category: business
icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/akaunting.svg
latest: "3"

View File

@@ -0,0 +1,40 @@
# Akaunting
Akaunting is an open-source accounting software for small businesses and freelancers.
## Dependencies
- **MySQL** - Database for storing accounting data
- **SMTP** - For sending invoices and notifications
## Configuration
Key settings in `config.yaml`:
- **domain** - Where Akaunting will be accessible
- **storage** - Persistent volume size (default: `2Gi`)
- **companyName** - Your company name (default: `My Company`)
- **companyEmail** - Company contact email (defaults to your operator email)
- **adminEmail** - Admin account email (defaults to your operator email)
- **locale** - Language/locale setting (default: `en-US`)
- **smtp** - Email settings inherited from your Wild Cloud SMTP service
## First-Time Setup
1. Add and deploy the app:
```bash
wild app add akaunting
wild app deploy akaunting
```
2. Log in with:
- **Email**: value of `adminEmail` in your config
- **Password**: value of `adminPassword` in your `secrets.yaml`
3. Set up your company details, chart of accounts, and start recording income and expenses.
## Notes
- Akaunting supports multiple companies in a single installation — additional companies can be added after login
- The `dbPrefix` config (`aka_`) prefixes all database table names to avoid conflicts
- Invoices, payments, and reports can be exported as PDF

View File

@@ -0,0 +1,64 @@
apiVersion: batch/v1
kind: Job
metadata:
name: akaunting-db-init
labels:
component: db-init
spec:
template:
metadata:
labels:
component: db-init
spec:
restartPolicy: OnFailure
securityContext:
runAsNonRoot: true
runAsUser: 999
runAsGroup: 999
seccompProfile:
type: RuntimeDefault
containers:
- name: mysql-init
image: mysql:9.1.0
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
readOnlyRootFilesystem: false
env:
- name: MYSQL_ROOT_PASSWORD
valueFrom:
secretKeyRef:
name: akaunting-secrets
key: mysql.rootPassword
- name: DB_HOSTNAME
value: {{ .db.host }}
- name: DB_PORT
value: "{{ .db.port }}"
- name: DB_DATABASE_NAME
value: {{ .db.name }}
- name: DB_USERNAME
value: {{ .db.user }}
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: akaunting-secrets
key: dbPassword
command:
- /bin/bash
- -c
- |
set -e
until mysql -h ${DB_HOSTNAME} -P ${DB_PORT} -u root -p${MYSQL_ROOT_PASSWORD} -e "SELECT 1" 2>/dev/null; do
echo "Waiting for MySQL..."
sleep 2
done
mysql -h ${DB_HOSTNAME} -P ${DB_PORT} -u root -p${MYSQL_ROOT_PASSWORD} <<EOF
CREATE DATABASE IF NOT EXISTS ${DB_DATABASE_NAME} CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER IF NOT EXISTS '${DB_USERNAME}'@'%' IDENTIFIED BY '${DB_PASSWORD}';
ALTER USER '${DB_USERNAME}'@'%' IDENTIFIED BY '${DB_PASSWORD}';
GRANT ALL PRIVILEGES ON ${DB_DATABASE_NAME}.* TO '${DB_USERNAME}'@'%';
FLUSH PRIVILEGES;
EOF
echo "Done"

View File

@@ -0,0 +1,114 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: akaunting
namespace: akaunting
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
component: web
template:
metadata:
labels:
component: web
spec:
securityContext:
runAsUser: 0
runAsNonRoot: false
seccompProfile:
type: RuntimeDefault
containers:
- name: akaunting
image: akaunting/akaunting:3.1.21
ports:
- name: http
containerPort: 80
protocol: TCP
env:
- name: AKAUNTING_SETUP
value: "true"
- name: APP_URL
value: https://{{ .domain }}
- name: LOCALE
value: {{ .locale }}
- name: DB_HOST
value: {{ .db.host }}
- name: DB_PORT
value: "{{ .db.port }}"
- name: DB_NAME
value: {{ .db.name }}
- name: DB_USERNAME
value: {{ .db.user }}
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: akaunting-secrets
key: dbPassword
- name: DB_PREFIX
value: {{ .dbPrefix }}
- name: COMPANY_NAME
value: "{{ .companyName }}"
- name: COMPANY_EMAIL
value: {{ .companyEmail }}
- name: ADMIN_EMAIL
value: {{ .adminEmail }}
- name: ADMIN_PASSWORD
valueFrom:
secretKeyRef:
name: akaunting-secrets
key: adminPassword
- name: MAIL_MAILER
value: smtp
- name: MAIL_HOST
value: {{ .smtp.host }}
- name: MAIL_PORT
value: "{{ .smtp.port }}"
- name: MAIL_USERNAME
value: {{ .smtp.user }}
- name: MAIL_PASSWORD
valueFrom:
secretKeyRef:
name: akaunting-secrets
key: smtpPassword
- name: MAIL_FROM_ADDRESS
value: {{ .smtp.from }}
resources:
limits:
cpu: "1"
ephemeral-storage: 1Gi
memory: 512Mi
requests:
cpu: 50m
ephemeral-storage: 50Mi
memory: 256Mi
volumeMounts:
- name: akaunting-data
mountPath: /var/www/html/storage
subPath: storage
- name: akaunting-data
mountPath: /var/www/html/public/uploads
subPath: uploads
livenessProbe:
tcpSocket:
port: 80
initialDelaySeconds: 120
timeoutSeconds: 10
periodSeconds: 30
failureThreshold: 6
readinessProbe:
tcpSocket:
port: 80
initialDelaySeconds: 60
timeoutSeconds: 5
periodSeconds: 15
failureThreshold: 3
securityContext:
readOnlyRootFilesystem: false
volumes:
- name: akaunting-data
persistentVolumeClaim:
claimName: akaunting-data
restartPolicy: Always

View File

@@ -0,0 +1,18 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: akaunting
namespace: akaunting
spec:
ingressClassName: traefik
rules:
- host: {{ .domain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: akaunting
port:
number: 80

View File

@@ -0,0 +1,16 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: akaunting
labels:
- includeSelectors: true
pairs:
app: akaunting
managedBy: kustomize
partOf: wild-cloud
resources:
- namespace.yaml
- db-init-job.yaml
- deployment.yaml
- service.yaml
- ingress.yaml
- pvc.yaml

View File

@@ -0,0 +1,29 @@
version: 3.1.21-2
requires:
- name: mysql
- name: smtp
defaultConfig:
namespace: akaunting
domain: akaunting.{{ .cloud.domain }}
storage: 2Gi
locale: en-US
dbPrefix: aka_
companyName: My Company
companyEmail: '{{ .operator.email }}'
adminEmail: '{{ .operator.email }}'
db:
host: '{{ .apps.mysql.host }}'
port: '3306'
name: akaunting
user: akaunting
smtp:
host: '{{ .apps.smtp.host }}'
port: '{{ .apps.smtp.port }}'
from: '{{ .apps.smtp.from }}'
user: '{{ .apps.smtp.user }}'
defaultSecrets:
- key: dbPassword
- key: adminPassword
- key: smtpPassword
requiredSecrets:
- mysql.rootPassword

View File

@@ -0,0 +1,11 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: akaunting-data
namespace: akaunting
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: {{ .storage }}

View File

@@ -0,0 +1,13 @@
apiVersion: v1
kind: Service
metadata:
name: akaunting
namespace: akaunting
spec:
selector:
component: web
ports:
- name: http
port: 80
targetPort: 80
protocol: TCP

6
aptly/app.yaml Normal file
View File

@@ -0,0 +1,6 @@
name: aptly
is: aptly
description: Aptly is a Debian/Ubuntu APT repository management tool for mirroring, snapshotting, and publishing package repositories.
category: developer
icon: https://github.com/aptly-dev.png
latest: "1"

View File

@@ -0,0 +1,84 @@
# Aptly
Aptly is a Debian/Ubuntu APT repository management tool. Use it to create and publish private APT repositories that your machines can install from.
## Configuration
Key settings in your instance's `config.yaml`:
- **domain** - Where aptly will be accessible (default: `aptly.{your-cloud-domain}`)
- **storage** - Persistent volume size for packages (default: `5Gi`)
## Access
After deployment:
- `https://aptly.{your-cloud-domain}/` — Published repository root (for APT clients, no auth required)
- `https://aptly.{your-cloud-domain}/api` — REST API for managing repos and snapshots (requires credentials)
- `https://aptly.{your-cloud-domain}/public.key` — GPG public key for APT clients to import
## Credentials
The API is protected by HTTP basic authentication. The username defaults to `aptly` (configurable via `apiUser` in `config.yaml`). The password is auto-generated and stored in your instance's `secrets.yaml` under `apps.aptly.apiPassword`.
To retrieve it:
```bash
wild secret get aptly apiPassword
```
To use the API with curl:
```bash
curl -u aptly:{your-api-password} https://aptly.{your-cloud-domain}/api/version
```
## GPG Signing
A GPG signing key is generated automatically on first deployment and stored on the persistent volume. The public key is exported to `/public.key` and is accessible without authentication so APT clients can import it:
```bash
curl -fsSL https://aptly.{your-cloud-domain}/public.key | \
sudo tee /usr/share/keyrings/my-repo.gpg > /dev/null
```
## Common Workflows
Aptly is managed through its REST API or the `aptly` CLI (run inside the pod). The REST API docs are at https://www.aptly.info/doc/api/.
### Running aptly commands inside the pod
```bash
kubectl -n aptly exec -it deploy/aptly -- bash
```
### Publish a local repository
```bash
# Create a local repo
aptly repo create my-packages
# Add packages
aptly repo add my-packages /path/to/package.deb
# Publish
aptly publish repo my-packages
```
The published repo will be available at `https://aptly.{your-cloud-domain}/`.
### Configure a machine to use the repository
```bash
# Import the signing key
curl -fsSL https://aptly.{your-cloud-domain}/public.key | \
sudo tee /usr/share/keyrings/my-repo.gpg > /dev/null
# Add the repo
echo "deb [signed-by=/usr/share/keyrings/my-repo.gpg] https://aptly.{your-cloud-domain}/ stable main" | \
sudo tee /etc/apt/sources.list.d/my-repo.list
sudo apt update
```
## Notes
- All aptly data (GPG keys, database, package pool, published repos) is stored on the persistent volume at `/opt/aptly`.
- The REST API (port 8080) and the nginx file server (port 80) both run inside the pod via supervisord. The ingress routes to nginx (port 80).

View File

@@ -0,0 +1,78 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: aptly
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
component: server
template:
metadata:
labels:
component: server
spec:
securityContext:
seccompProfile:
type: RuntimeDefault
initContainers:
- name: init-gpg
image: urpylka/aptly:1.6.2
command:
- sh
- -c
- |
export GNUPGHOME=/opt/aptly/gpg
mkdir -p "$GNUPGHOME" /opt/aptly/public
chmod 700 "$GNUPGHOME"
if gpg --list-secret-keys 2>/dev/null | grep -q '^sec'; then
echo "GPG key already exists, skipping"
else
echo "Generating GPG signing key..."
printf '%%no-protection\nKey-Type: RSA\nKey-Length: 4096\nName-Real: Wild Cloud APT Repository\nName-Email: {{ .operatorEmail }}\nExpire-Date: 0\n%%commit\n' | gpg --batch --gen-key
echo "GPG key generated"
fi
gpg --export --armor > /opt/aptly/public/public.key
securityContext:
allowPrivilegeEscalation: false
volumeMounts:
- name: data
mountPath: /opt/aptly
- name: init-htpasswd
image: httpd:alpine
command:
- sh
- -c
- htpasswd -bc /opt/aptly/api.htpasswd "$API_USER" "$API_PASSWORD"
env:
- name: API_USER
value: "{{ .apiUser }}"
- name: API_PASSWORD
valueFrom:
secretKeyRef:
name: aptly-secrets
key: apiPassword
securityContext:
allowPrivilegeEscalation: false
volumeMounts:
- name: data
mountPath: /opt/aptly
containers:
- name: aptly
image: urpylka/aptly:1.6.2
ports:
- containerPort: 80
name: http
- containerPort: 8080
name: api
securityContext:
allowPrivilegeEscalation: false
volumeMounts:
- name: data
mountPath: /opt/aptly
volumes:
- name: data
persistentVolumeClaim:
claimName: aptly-pvc

View File

@@ -0,0 +1,17 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: aptly
spec:
ingressClassName: traefik
rules:
- host: {{ .domain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: aptly
port:
number: 80

View File

@@ -0,0 +1,15 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: "{{ .namespace }}"
labels:
- includeSelectors: true
pairs:
app: aptly
managedBy: kustomize
partOf: wild-cloud
resources:
- namespace.yaml
- deployment.yaml
- service.yaml
- ingress.yaml
- pvc.yaml

View File

@@ -0,0 +1,9 @@
version: 1.6.2-4
defaultConfig:
namespace: aptly
domain: aptly.{{ .cloud.domain }}
storage: 5Gi
apiUser: aptly
operatorEmail: '{{ .operator.email }}'
defaultSecrets:
- key: apiPassword

View File

@@ -0,0 +1,4 @@
apiVersion: v1
kind: Namespace
metadata:
name: "{{ .namespace }}"

12
aptly/versions/1/pvc.yaml Normal file
View File

@@ -0,0 +1,12 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: aptly-pvc
spec:
storageClassName: longhorn
accessModes:
- ReadWriteOnce
volumeMode: Filesystem
resources:
requests:
storage: {{ .storage }}

View File

@@ -0,0 +1,14 @@
apiVersion: v1
kind: Service
metadata:
name: aptly
spec:
ports:
- port: 80
targetPort: 80
name: http
- port: 8080
targetPort: 8080
name: api
selector:
component: server

6
baserow/app.yaml Normal file
View File

@@ -0,0 +1,6 @@
name: baserow
is: baserow
description: Baserow is an open-source no-code database platform and Airtable alternative. Create and manage databases through a spreadsheet-like interface without writing code.
category: business
icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/baserow.svg
latest: "2"

View File

@@ -0,0 +1,38 @@
# Baserow
Baserow is an open-source no-code database platform — a self-hosted alternative to Airtable.
## Dependencies
- **PostgreSQL** - Database for storing tables and workspace data
- **Redis** - Used for caching and background job queuing
## Configuration
Key settings in `config.yaml`:
- **domain** - Where Baserow will be accessible
- **storage** - Persistent volume size (default: `2Gi`)
- **db.name** - Database name (default: `baserow`)
## First-Time Setup
1. Add and deploy the app:
```bash
wild app add baserow
wild app deploy baserow
```
2. Visit the app URL and sign up to create your account.
3. The first user to sign up can be promoted to staff/admin via the Django admin panel at `/api/admin/`.
## Notes
- To make a user a staff member (admin):
```bash
kubectl exec -n baserow deploy/baserow -- python /baserow/backend/manage.py shell \
-c "from django.contrib.auth import get_user_model; u = get_user_model().objects.get(email='your@email.com'); u.is_staff = True; u.save()"
```
- The `secretKey` is auto-generated in `secrets.yaml`
- Baserow supports importing data from CSV, JSON, and XML files

View File

@@ -0,0 +1,63 @@
apiVersion: batch/v1
kind: Job
metadata:
name: baserow-db-init
namespace: {{ .namespace }}
labels:
component: db-init
spec:
template:
metadata:
labels:
component: db-init
spec:
securityContext:
runAsNonRoot: true
runAsUser: 999
runAsGroup: 999
seccompProfile:
type: RuntimeDefault
containers:
- name: db-init
image: postgres:17
command: ["/bin/bash", "-c"]
args:
- |
PGPASSWORD=${POSTGRES_ADMIN_PASSWORD} psql -h ${DB_HOSTNAME} -U postgres <<EOF
DO \$\$
BEGIN
IF NOT EXISTS (SELECT FROM pg_catalog.pg_roles WHERE rolname = '${DB_USERNAME}') THEN
CREATE USER ${DB_USERNAME} WITH ENCRYPTED PASSWORD '${DB_PASSWORD}';
ELSE
ALTER USER ${DB_USERNAME} WITH ENCRYPTED PASSWORD '${DB_PASSWORD}';
END IF;
END
\$\$;
SELECT 'CREATE DATABASE ${DB_DATABASE_NAME}' WHERE NOT EXISTS (SELECT FROM pg_database WHERE datname = '${DB_DATABASE_NAME}')\gexec
ALTER DATABASE ${DB_DATABASE_NAME} OWNER TO ${DB_USERNAME};
GRANT ALL PRIVILEGES ON DATABASE ${DB_DATABASE_NAME} TO ${DB_USERNAME};
EOF
env:
- name: POSTGRES_ADMIN_PASSWORD
valueFrom:
secretKeyRef:
name: postgres-secrets
key: password
- name: DB_HOSTNAME
value: "{{ .db.host }}"
- name: DB_DATABASE_NAME
value: "{{ .db.name }}"
- name: DB_USERNAME
value: "{{ .db.user }}"
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: baserow-secrets
key: dbPassword
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
restartPolicy: OnFailure

View File

@@ -0,0 +1,107 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: baserow
namespace: {{ .namespace }}
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
component: web
template:
metadata:
labels:
component: web
spec:
securityContext:
runAsNonRoot: false
runAsUser: 0
seccompProfile:
type: RuntimeDefault
containers:
- name: baserow
image: baserow/baserow:2.2.2
ports:
- name: http
containerPort: 80
protocol: TCP
env:
- name: BASEROW_PUBLIC_URL
value: https://{{ .domain }}
- name: DATABASE_HOST
value: "{{ .db.host }}"
- name: DATABASE_PORT
value: "{{ .db.port }}"
- name: DATABASE_NAME
value: "{{ .db.name }}"
- name: DATABASE_USER
value: "{{ .db.user }}"
- name: DATABASE_PASSWORD
valueFrom:
secretKeyRef:
name: baserow-secrets
key: dbPassword
- name: REDIS_HOST
value: "{{ .redis.host }}"
- name: REDIS_PORT
value: "6379"
- name: REDIS_PASSWORD
valueFrom:
secretKeyRef:
name: baserow-secrets
key: redis.password
- name: SECRET_KEY
valueFrom:
secretKeyRef:
name: baserow-secrets
key: secretKey
resources:
limits:
cpu: "2"
ephemeral-storage: 1Gi
memory: 2Gi
requests:
cpu: 50m
ephemeral-storage: 50Mi
memory: 256Mi
volumeMounts:
- name: baserow-data
mountPath: /baserow/data
securityContext:
runAsNonRoot: false
runAsUser: 0
allowPrivilegeEscalation: false
capabilities:
drop: [ALL]
readOnlyRootFilesystem: false
seccompProfile:
type: RuntimeDefault
livenessProbe:
httpGet:
path: /api/_health/
port: 80
httpHeaders:
- name: Host
value: "{{ .domain }}"
initialDelaySeconds: 300
timeoutSeconds: 10
periodSeconds: 30
failureThreshold: 6
readinessProbe:
httpGet:
path: /api/_health/
port: 80
httpHeaders:
- name: Host
value: "{{ .domain }}"
initialDelaySeconds: 120
timeoutSeconds: 5
periodSeconds: 15
failureThreshold: 6
volumes:
- name: baserow-data
persistentVolumeClaim:
claimName: baserow-data
restartPolicy: Always

View File

@@ -0,0 +1,18 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: baserow
namespace: {{ .namespace }}
spec:
ingressClassName: traefik
rules:
- host: {{ .domain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: baserow
port:
number: 80

View File

@@ -0,0 +1,16 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: {{ .namespace }}
labels:
- includeSelectors: true
pairs:
app: baserow
managedBy: kustomize
partOf: wild-cloud
resources:
- namespace.yaml
- deployment.yaml
- service.yaml
- ingress.yaml
- pvc.yaml
- db-init-job.yaml

View File

@@ -0,0 +1,21 @@
version: 2.2.2-3
requires:
- name: postgres
- name: redis
defaultConfig:
namespace: baserow
domain: baserow.{{ .cloud.domain }}
storage: 2Gi
db:
host: '{{ .apps.postgres.host }}'
port: '5432'
name: baserow
user: baserow
redis:
host: '{{ .apps.redis.host }}'
defaultSecrets:
- key: dbPassword
- key: secretKey
requiredSecrets:
- postgres.password
- redis.password

View File

@@ -0,0 +1,4 @@
apiVersion: v1
kind: Namespace
metadata:
name: {{ .namespace }}

View File

@@ -0,0 +1,11 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: baserow-data
namespace: {{ .namespace }}
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: {{ .storage }}

View File

@@ -0,0 +1,13 @@
apiVersion: v1
kind: Service
metadata:
name: baserow
namespace: {{ .namespace }}
spec:
selector:
component: web
ports:
- name: http
port: 80
targetPort: 80
protocol: TCP

6
bookstack/app.yaml Normal file
View File

@@ -0,0 +1,6 @@
name: bookstack
is: bookstack
description: BookStack is a simple, self-hosted, easy-to-use platform for organising and storing information.
category: productivity
icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/bookstack.svg
latest: "26"

View File

@@ -0,0 +1,39 @@
# BookStack
BookStack is a simple, self-hosted platform for organising and storing information in a hierarchical structure of Books, Chapters, and Pages.
## Dependencies
- **MySQL** - Database for storing content and users
- **SMTP** - For email notifications and password resets
## Configuration
Key settings in `config.yaml`:
- **domain** - Where BookStack will be accessible
- **storage** - Persistent volume size (default: `2Gi`)
- **db.name** - Database name (default: `bookstack`)
- **smtp** - Email settings inherited from your Wild Cloud SMTP service
## First-Time Setup
1. Add and deploy the app:
```bash
wild app add bookstack
wild app deploy bookstack
```
2. Log in with the default admin credentials:
- **Email**: `admin@admin.com`
- **Password**: `password`
3. **Immediately change the admin email and password** via **Settings → Your Profile**.
4. Start creating Books, Chapters, and Pages from the dashboard.
## Notes
- BookStack uses the linuxserver.io image which runs as root internally — this is expected and required for the image to function
- SMTP settings are configured via the `smtp` section in your config
- The `appKey` secret is auto-generated and used for encrypting data — do not change it after content has been created

View File

@@ -0,0 +1,64 @@
apiVersion: batch/v1
kind: Job
metadata:
name: bookstack-db-init
labels:
component: db-init
spec:
template:
metadata:
labels:
component: db-init
spec:
restartPolicy: OnFailure
securityContext:
runAsNonRoot: true
runAsUser: 999
runAsGroup: 999
seccompProfile:
type: RuntimeDefault
containers:
- name: mysql-init
image: mysql:9.1.0
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
readOnlyRootFilesystem: false
env:
- name: MYSQL_ROOT_PASSWORD
valueFrom:
secretKeyRef:
name: bookstack-secrets
key: mysql.rootPassword
- name: DB_HOSTNAME
value: {{ .db.host }}
- name: DB_PORT
value: "{{ .db.port }}"
- name: DB_DATABASE_NAME
value: {{ .db.name }}
- name: DB_USERNAME
value: {{ .db.user }}
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: bookstack-secrets
key: dbPassword
command:
- /bin/bash
- -c
- |
set -e
until mysql -h ${DB_HOSTNAME} -P ${DB_PORT} -u root -p${MYSQL_ROOT_PASSWORD} -e "SELECT 1" 2>/dev/null; do
echo "Waiting for MySQL..."
sleep 2
done
mysql -h ${DB_HOSTNAME} -P ${DB_PORT} -u root -p${MYSQL_ROOT_PASSWORD} <<EOF
CREATE DATABASE IF NOT EXISTS ${DB_DATABASE_NAME} CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER IF NOT EXISTS '${DB_USERNAME}'@'%' IDENTIFIED BY '${DB_PASSWORD}';
ALTER USER '${DB_USERNAME}'@'%' IDENTIFIED BY '${DB_PASSWORD}';
GRANT ALL PRIVILEGES ON ${DB_DATABASE_NAME}.* TO '${DB_USERNAME}'@'%';
FLUSH PRIVILEGES;
EOF
echo "Done"

View File

@@ -0,0 +1,106 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: bookstack
namespace: {{ .namespace }}
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
component: web
template:
metadata:
labels:
component: web
spec:
securityContext:
runAsUser: 0
runAsNonRoot: false
seccompProfile:
type: RuntimeDefault
containers:
- name: bookstack
image: lscr.io/linuxserver/bookstack:26.05.1
ports:
- name: http
containerPort: 80
protocol: TCP
env:
- name: PUID
value: "1000"
- name: PGID
value: "1000"
- name: APP_URL
value: https://{{ .domain }}
- name: DB_HOST
value: {{ .db.host }}
- name: DB_PORT
value: "{{ .db.port }}"
- name: DB_DATABASE
value: {{ .db.name }}
- name: DB_USERNAME
value: {{ .db.user }}
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: bookstack-secrets
key: dbPassword
- name: APP_KEY
valueFrom:
secretKeyRef:
name: bookstack-secrets
key: appKey
- name: MAIL_DRIVER
value: smtp
- name: MAIL_HOST
value: {{ .smtp.host }}
- name: MAIL_PORT
value: "{{ .smtp.port }}"
- name: MAIL_FROM
value: {{ .smtp.from }}
- name: MAIL_USERNAME
value: {{ .smtp.user }}
- name: MAIL_PASSWORD
valueFrom:
secretKeyRef:
name: bookstack-secrets
key: smtpPassword
- name: MAIL_ENCRYPTION
value: tls
resources:
limits:
cpu: "1"
ephemeral-storage: 1Gi
memory: 512Mi
requests:
cpu: 50m
ephemeral-storage: 50Mi
memory: 128Mi
volumeMounts:
- name: bookstack-data
mountPath: /config
livenessProbe:
httpGet:
path: /
port: 80
initialDelaySeconds: 90
timeoutSeconds: 5
periodSeconds: 15
failureThreshold: 6
readinessProbe:
httpGet:
path: /
port: 80
initialDelaySeconds: 60
timeoutSeconds: 3
periodSeconds: 10
failureThreshold: 3
securityContext:
readOnlyRootFilesystem: false
volumes:
- name: bookstack-data
persistentVolumeClaim:
claimName: bookstack-data
restartPolicy: Always

View File

@@ -0,0 +1,18 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: bookstack
namespace: {{ .namespace }}
spec:
ingressClassName: traefik
rules:
- host: {{ .domain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: bookstack
port:
number: 80

View File

@@ -0,0 +1,16 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: {{ .namespace }}
labels:
- includeSelectors: true
pairs:
app: bookstack
managedBy: kustomize
partOf: wild-cloud
resources:
- namespace.yaml
- db-init-job.yaml
- deployment.yaml
- service.yaml
- ingress.yaml
- pvc.yaml

View File

@@ -0,0 +1,24 @@
version: 26.05.1-3
requires:
- name: mysql
- name: smtp
defaultConfig:
namespace: bookstack
domain: bookstack.{{ .cloud.domain }}
storage: 2Gi
db:
host: '{{ .apps.mysql.host }}'
port: '3306'
name: bookstack
user: bookstack
smtp:
host: '{{ .apps.smtp.host }}'
port: '{{ .apps.smtp.port }}'
from: '{{ .apps.smtp.from }}'
user: '{{ .apps.smtp.user }}'
defaultSecrets:
- key: appKey
- key: dbPassword
- key: smtpPassword
requiredSecrets:
- mysql.rootPassword

View File

@@ -0,0 +1,4 @@
apiVersion: v1
kind: Namespace
metadata:
name: {{ .namespace }}

View File

@@ -0,0 +1,11 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: bookstack-data
namespace: {{ .namespace }}
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: {{ .storage }}

View File

@@ -0,0 +1,13 @@
apiVersion: v1
kind: Service
metadata:
name: bookstack
namespace: {{ .namespace }}
spec:
selector:
component: web
ports:
- name: http
port: 80
targetPort: 80
protocol: TCP

6
bookwyrm/app.yaml Normal file
View File

@@ -0,0 +1,6 @@
name: bookwyrm
is: bookwyrm
description: BookWyrm is a federated social reading platform using ActivityPub. Track your reading, write reviews, and connect with readers across the fediverse.
category: social
icon: https://raw.githubusercontent.com/bookwyrm-social/bookwyrm/main/bookwyrm/static/images/logo.png
latest: "0"

38
bookwyrm/notes.md Normal file
View File

@@ -0,0 +1,38 @@
# BookWyrm — Notes
## SCSS themes must be compiled before collectstatic
BookWyrm ships SCSS source files instead of pre-compiled CSS. The static root is an `emptyDir`
(ephemeral), so it is empty on every pod restart. Running `collectstatic` alone fails:
```
ValueError: Missing staticfiles manifest entry for 'css/themes/...'
```
**Fix**: compile themes before collecting static files:
```yaml
command: ["/bin/sh", "-c"]
args:
- |
python manage.py compile_themes \
&& python manage.py collectstatic --noinput \
&& python manage.py migrate \
&& exec gunicorn bookwyrm.wsgi:application ...
```
Check the image's `Dockerfile` or `docker_start.sh` to confirm the current required build steps.
## PostgreSQL extensions require superuser
BookWyrm uses extensions (`bloom`, `pg_trgm`, etc.) that require superuser to install. Migrations
fail with `permission denied to create extension "bloom"` if the app DB user is not a superuser.
**Fix**: create the extensions in the `db-init-job`, which connects as the `postgres` superuser:
```bash
psql -d "$APP_DB_NAME" -c "CREATE EXTENSION IF NOT EXISTS bloom;"
psql -d "$APP_DB_NAME" -c "CREATE EXTENSION IF NOT EXISTS pg_trgm;"
```
This must run before migrations (i.e. in `db-init-job`, not in the app startup command).

View File

@@ -0,0 +1,35 @@
# BookWyrm
BookWyrm is a federated social reading platform — a self-hosted alternative to Goodreads, connected to the ActivityPub network.
## Dependencies
- **PostgreSQL** - Database for storing books, reviews, and user data
- **Redis** - Used for caching and background job queuing
- **SMTP** - For account verification and notifications
## Configuration
Key settings in `config.yaml`:
- **domain** - Where BookWyrm will be accessible
- **storage** - Persistent volume size (default: `2Gi`)
- **smtp** - Email settings inherited from your Wild Cloud SMTP service
## First-Time Setup
1. Add and deploy the app:
```bash
wild app add bookwyrm
wild app deploy bookwyrm
```
2. Visit the app URL — on first load, a setup wizard will guide you through creating the admin account and configuring the instance.
3. After setup, log in and configure the instance settings (name, description, registration policy) from the admin panel at `/settings/`.
## Notes
- BookWyrm federates with other BookWyrm instances and Mastodon via ActivityPub — users on other instances can follow and interact with your users
- Book metadata is imported from OpenLibrary and Inventaire — internet access is required for book search to work
- The `secretKey` is auto-generated in `secrets.yaml`

View File

@@ -0,0 +1,86 @@
apiVersion: batch/v1
kind: Job
metadata:
name: bookwyrm-db-init
namespace: bookwyrm
spec:
template:
metadata:
labels:
component: db-init
spec:
securityContext:
runAsNonRoot: true
runAsUser: 999
runAsGroup: 999
seccompProfile:
type: RuntimeDefault
restartPolicy: OnFailure
containers:
- name: db-init
image: postgres:16-alpine
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
readOnlyRootFilesystem: false
env:
- name: PGHOST
value: "{{ .db.host }}"
- name: PGPORT
value: "{{ .db.port }}"
- name: PGUSER
value: postgres
- name: PGPASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: postgres.password
- name: BOOKWYRM_DB_USER
value: "{{ .db.user }}"
- name: BOOKWYRM_DB_NAME
value: "{{ .db.name }}"
- name: BOOKWYRM_DB_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: dbPassword
command:
- /bin/sh
- -c
- |
echo "Initializing BookWyrm database..."
# Create user if it doesn't exist
psql -c "
DO \$\$
BEGIN
IF NOT EXISTS (SELECT FROM pg_catalog.pg_roles WHERE rolname = '$BOOKWYRM_DB_USER') THEN
CREATE USER \"$BOOKWYRM_DB_USER\" WITH PASSWORD '$BOOKWYRM_DB_PASSWORD';
ELSE
ALTER USER \"$BOOKWYRM_DB_USER\" WITH PASSWORD '$BOOKWYRM_DB_PASSWORD';
END IF;
END
\$\$;
"
# Create database if it doesn't exist
if ! psql -lqt | cut -d \| -f 1 | grep -qw "$BOOKWYRM_DB_NAME"; then
echo "Creating database $BOOKWYRM_DB_NAME..."
createdb -O "$BOOKWYRM_DB_USER" "$BOOKWYRM_DB_NAME"
else
echo "Database $BOOKWYRM_DB_NAME already exists."
fi
# Grant privileges
psql -d "$BOOKWYRM_DB_NAME" -c "
GRANT ALL PRIVILEGES ON DATABASE \"$BOOKWYRM_DB_NAME\" TO \"$BOOKWYRM_DB_USER\";
GRANT ALL ON SCHEMA public TO \"$BOOKWYRM_DB_USER\";
GRANT USAGE ON SCHEMA public TO \"$BOOKWYRM_DB_USER\";
"
# Create bloom extension (required by bookwyrm migrations, needs superuser)
psql -d "$BOOKWYRM_DB_NAME" -c "CREATE EXTENSION IF NOT EXISTS bloom;"
echo "Database initialization completed."

View File

@@ -0,0 +1,120 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: bookwyrm-worker
namespace: bookwyrm
spec:
replicas: 1
strategy:
type: RollingUpdate
selector:
matchLabels:
component: worker
template:
metadata:
labels:
component: worker
spec:
securityContext:
runAsNonRoot: false
runAsUser: 0
seccompProfile:
type: RuntimeDefault
containers:
- name: celery-worker
image: ghcr.io/bookwyrm-social/bookwyrm:v0.8.6
command:
- celery
- -A
- celerywyrm
- worker
- --pool=threads
- --concurrency=10
- -l
- info
- -Q
- high_priority,medium_priority,low_priority,streams,images,suggested_users,email,connectors,lists,inbox,imports,import_triggered,broadcast,misc
env:
- name: SECRET_KEY
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: secretKey
- name: DEBUG
value: "false"
- name: DOMAIN
value: {{ .domain }}
- name: ALLOWED_HOSTS
value: {{ .domain }}
- name: EMAIL
value: {{ .smtp.from }}
- name: POSTGRES_HOST
value: {{ .db.host }}
- name: PGPORT
value: "{{ .db.port }}"
- name: POSTGRES_DB
value: {{ .db.name }}
- name: POSTGRES_USER
value: {{ .db.user }}
- name: POSTGRES_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: dbPassword
- name: REDIS_ACTIVITY_HOST
value: {{ .redis.host }}
- name: REDIS_ACTIVITY_PORT
value: "6379"
- name: REDIS_ACTIVITY_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: redis.password
- name: REDIS_ACTIVITY_URL
value: redis://:$(REDIS_ACTIVITY_PASSWORD)@{{ .redis.host }}:6379/0
- name: REDIS_BROKER_HOST
value: {{ .redis.host }}
- name: REDIS_BROKER_PORT
value: "6379"
- name: REDIS_BROKER_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: redis.password
- name: REDIS_BROKER_URL
value: redis://:$(REDIS_BROKER_PASSWORD)@{{ .redis.host }}:6379/1
- name: EMAIL_HOST
value: {{ .smtp.host }}
- name: EMAIL_PORT
value: "{{ .smtp.port }}"
- name: EMAIL_HOST_USER
value: {{ .smtp.user }}
- name: EMAIL_HOST_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: smtpPassword
- name: EMAIL_USE_TLS
value: "true"
- name: EMAIL_USE_SSL
value: "false"
- name: MEDIA_ROOT
value: /app/images
- name: STATIC_ROOT
value: /app/static
resources:
limits:
cpu: 1000m
ephemeral-storage: 1Gi
memory: 1Gi
requests:
cpu: 50m
ephemeral-storage: 50Mi
memory: 256Mi
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
readOnlyRootFilesystem: false
restartPolicy: Always

View File

@@ -0,0 +1,149 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: bookwyrm
namespace: bookwyrm
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
component: web
template:
metadata:
labels:
component: web
spec:
securityContext:
runAsNonRoot: false
runAsUser: 0
seccompProfile:
type: RuntimeDefault
containers:
- name: bookwyrm
image: ghcr.io/bookwyrm-social/bookwyrm:v0.8.6
command: ["/bin/sh", "-c", "python manage.py compile_themes && python manage.py collectstatic --noinput && python manage.py migrate && exec gunicorn bookwyrm.wsgi:application"]
ports:
- name: http
containerPort: 8000
protocol: TCP
env:
- name: SECRET_KEY
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: secretKey
- name: DEBUG
value: "false"
- name: DOMAIN
value: {{ .domain }}
- name: ALLOWED_HOSTS
value: {{ .domain }}
- name: EMAIL
value: {{ .smtp.from }}
- name: POSTGRES_HOST
value: {{ .db.host }}
- name: PGPORT
value: "{{ .db.port }}"
- name: POSTGRES_DB
value: {{ .db.name }}
- name: POSTGRES_USER
value: {{ .db.user }}
- name: POSTGRES_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: dbPassword
- name: REDIS_ACTIVITY_HOST
value: {{ .redis.host }}
- name: REDIS_ACTIVITY_PORT
value: "6379"
- name: REDIS_ACTIVITY_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: redis.password
- name: REDIS_ACTIVITY_URL
value: redis://:$(REDIS_ACTIVITY_PASSWORD)@{{ .redis.host }}:6379/0
- name: REDIS_BROKER_HOST
value: {{ .redis.host }}
- name: REDIS_BROKER_PORT
value: "6379"
- name: REDIS_BROKER_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: redis.password
- name: REDIS_BROKER_URL
value: redis://:$(REDIS_BROKER_PASSWORD)@{{ .redis.host }}:6379/1
- name: EMAIL_HOST
value: {{ .smtp.host }}
- name: EMAIL_PORT
value: "{{ .smtp.port }}"
- name: EMAIL_HOST_USER
value: {{ .smtp.user }}
- name: EMAIL_HOST_PASSWORD
valueFrom:
secretKeyRef:
name: bookwyrm-secrets
key: smtpPassword
- name: EMAIL_USE_TLS
value: "true"
- name: EMAIL_USE_SSL
value: "false"
- name: EMAIL_SENDER_NAME
value: BookWyrm
- name: EMAIL_SENDER_DOMAIN
value: {{ .domain }}
- name: MEDIA_ROOT
value: /app/images
- name: STATIC_ROOT
value: /app/static
- name: ENABLE_THUMBNAIL_GENERATION
value: "true"
resources:
limits:
cpu: 1000m
ephemeral-storage: 2Gi
memory: 1Gi
requests:
cpu: 50m
ephemeral-storage: 50Mi
memory: 256Mi
volumeMounts:
- name: bookwyrm-images
mountPath: /app/images
- name: bookwyrm-static
mountPath: /app/static
- name: bookwyrm-exports
mountPath: /app/exports
livenessProbe:
tcpSocket:
port: 8000
initialDelaySeconds: 120
timeoutSeconds: 10
periodSeconds: 30
failureThreshold: 6
readinessProbe:
tcpSocket:
port: 8000
initialDelaySeconds: 60
timeoutSeconds: 5
periodSeconds: 15
failureThreshold: 3
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
readOnlyRootFilesystem: false
volumes:
- name: bookwyrm-images
persistentVolumeClaim:
claimName: bookwyrm-images
- name: bookwyrm-static
emptyDir: {}
- name: bookwyrm-exports
emptyDir: {}
restartPolicy: Always

View File

@@ -0,0 +1,18 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: bookwyrm
namespace: bookwyrm
spec:
ingressClassName: traefik
rules:
- host: {{ .domain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: bookwyrm
port:
number: 80

View File

@@ -0,0 +1,17 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: {{ .namespace }}
labels:
- includeSelectors: true
pairs:
app: bookwyrm
managedBy: kustomize
partOf: wild-cloud
resources:
- namespace.yaml
- deployment.yaml
- deployment-worker.yaml
- service.yaml
- ingress.yaml
- pvc.yaml
- db-init-job.yaml

View File

@@ -0,0 +1,28 @@
version: 0.8.7-2
requires:
- name: postgres
- name: redis
- name: smtp
defaultConfig:
namespace: bookwyrm
domain: bookwyrm.{{ .cloud.domain }}
storage: 2Gi
db:
host: '{{ .apps.postgres.host }}'
port: '{{ .apps.postgres.port }}'
name: bookwyrm
user: bookwyrm
redis:
host: '{{ .apps.redis.host }}'
smtp:
host: '{{ .apps.smtp.host }}'
port: '{{ .apps.smtp.port }}'
from: '{{ .apps.smtp.from }}'
user: '{{ .apps.smtp.user }}'
defaultSecrets:
- key: secretKey
- key: dbPassword
- key: smtpPassword
requiredSecrets:
- postgres.password
- redis.password

View File

@@ -0,0 +1,4 @@
apiVersion: v1
kind: Namespace
metadata:
name: {{ .namespace }}

View File

@@ -0,0 +1,11 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: bookwyrm-images
namespace: bookwyrm
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: {{ .storage }}

View File

@@ -0,0 +1,13 @@
apiVersion: v1
kind: Service
metadata:
name: bookwyrm
namespace: bookwyrm
spec:
selector:
component: web
ports:
- name: http
port: 80
targetPort: 8000
protocol: TCP

View File

@@ -1,5 +1,6 @@
name: cert-manager name: cert-manager
is: cert-manager is: cert-manager
description: X.509 certificate management for Kubernetes description: X.509 certificate management for Kubernetes
category: infrastructure category: services
icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/cert-manager.svg
latest: "v1" latest: "v1"

View File

@@ -1,4 +1,4 @@
version: v1.17.2 version: v1.17.2-1
requires: requires:
- name: traefik - name: traefik
defaultConfig: defaultConfig:

6
chamilo/app.yaml Normal file
View File

@@ -0,0 +1,6 @@
name: chamilo
is: chamilo
description: Chamilo is a free and open-source e-learning platform (LMS) for course management, assessments, and online education.
category: education
icon: https://raw.githubusercontent.com/chamilo/chamilo-lms/master/public/img/logo.png
latest: "1"

View File

@@ -0,0 +1,39 @@
# Chamilo
Chamilo is an open-source Learning Management System (LMS) for creating and delivering online courses.
## Dependencies
- **MySQL** - Database for storing courses, users, and activity
- **SMTP** - For account verification and course notifications
## Configuration
Key settings in `config.yaml`:
- **domain** - Where Chamilo will be accessible
- **storage** - Persistent volume size (default: `2Gi`)
- **siteName** - Display name for the LMS (default: `Chamilo LMS`)
- **adminUser** - Admin account username (default: `admin`)
- **adminEmail** - Admin account email (defaults to your operator email)
- **smtp** - Email settings inherited from your Wild Cloud SMTP service
## First-Time Setup
1. Add and deploy the app:
```bash
wild app add chamilo
wild app deploy chamilo
```
2. Log in with:
- **Username**: value of `adminUser` in your config (default: `admin`)
- **Password**: value of `adminPassword` in your `secrets.yaml`
3. From the admin panel, create courses, enroll learners, and configure the LMS settings.
## Notes
- The admin panel is accessible via **Administration** in the top navigation after logging in
- Courses can be assigned to categories, and users can self-enroll or be enrolled by teachers
- SMTP is needed for sending course completion certificates and user notifications

View File

@@ -0,0 +1,64 @@
apiVersion: batch/v1
kind: Job
metadata:
name: chamilo-db-init
labels:
component: db-init
spec:
template:
metadata:
labels:
component: db-init
spec:
restartPolicy: OnFailure
securityContext:
runAsNonRoot: true
runAsUser: 999
runAsGroup: 999
seccompProfile:
type: RuntimeDefault
containers:
- name: mysql-init
image: mysql:9.1.0
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
readOnlyRootFilesystem: false
env:
- name: MYSQL_ROOT_PASSWORD
valueFrom:
secretKeyRef:
name: chamilo-secrets
key: mysql.rootPassword
- name: DB_HOSTNAME
value: {{ .db.host }}
- name: DB_PORT
value: "{{ .db.port }}"
- name: DB_DATABASE_NAME
value: {{ .db.name }}
- name: DB_USERNAME
value: {{ .db.user }}
- name: DB_PASSWORD
valueFrom:
secretKeyRef:
name: chamilo-secrets
key: dbPassword
command:
- /bin/bash
- -c
- |
set -e
until mysql -h ${DB_HOSTNAME} -P ${DB_PORT} -u root -p${MYSQL_ROOT_PASSWORD} -e "SELECT 1" 2>/dev/null; do
echo "Waiting for MySQL..."
sleep 2
done
mysql -h ${DB_HOSTNAME} -P ${DB_PORT} -u root -p${MYSQL_ROOT_PASSWORD} <<EOF
CREATE DATABASE IF NOT EXISTS ${DB_DATABASE_NAME} CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
CREATE USER IF NOT EXISTS '${DB_USERNAME}'@'%' IDENTIFIED BY '${DB_PASSWORD}';
ALTER USER '${DB_USERNAME}'@'%' IDENTIFIED BY '${DB_PASSWORD}';
GRANT ALL PRIVILEGES ON ${DB_DATABASE_NAME}.* TO '${DB_USERNAME}'@'%';
FLUSH PRIVILEGES;
EOF
echo "Done"

View File

@@ -0,0 +1,76 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: chamilo
namespace: {{ .namespace }}
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
component: web
template:
metadata:
labels:
component: web
spec:
securityContext:
runAsNonRoot: false
runAsUser: 0
seccompProfile:
type: RuntimeDefault
containers:
- name: chamilo
image: ipeos/chamilo:1.11.28
ports:
- name: http
containerPort: 80
protocol: TCP
env:
- name: PHP_TIMEZONE
value: UTC
- name: PHP_MEMORY_LIMIT
value: 256M
- name: PHP_MAX_EXECUTION_TIME
value: "300"
- name: PHP_UPLOAD_MAX_FILESIZE
value: 100M
- name: PHP_POST_MAX_SIZE
value: 100M
resources:
limits:
cpu: "1"
ephemeral-storage: 1Gi
memory: 512Mi
requests:
cpu: 50m
ephemeral-storage: 50Mi
memory: 256Mi
volumeMounts:
- name: chamilo-data
mountPath: /var/www/html
livenessProbe:
httpGet:
path: /
port: 80
initialDelaySeconds: 120
timeoutSeconds: 10
periodSeconds: 30
failureThreshold: 6
readinessProbe:
httpGet:
path: /
port: 80
initialDelaySeconds: 60
timeoutSeconds: 5
periodSeconds: 10
failureThreshold: 3
securityContext:
allowPrivilegeEscalation: true
readOnlyRootFilesystem: false
volumes:
- name: chamilo-data
persistentVolumeClaim:
claimName: chamilo-data
restartPolicy: Always

View File

@@ -0,0 +1,18 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: chamilo
namespace: {{ .namespace }}
spec:
ingressClassName: traefik
rules:
- host: {{ .domain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: chamilo
port:
number: 80

View File

@@ -0,0 +1,16 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: {{ .namespace }}
labels:
- includeSelectors: true
pairs:
app: chamilo
managedBy: kustomize
partOf: wild-cloud
resources:
- namespace.yaml
- db-init-job.yaml
- deployment.yaml
- service.yaml
- ingress.yaml
- pvc.yaml

View File

@@ -0,0 +1,27 @@
version: 1.11.28-2
requires:
- name: mysql
- name: smtp
defaultConfig:
namespace: chamilo
domain: chamilo.{{ .cloud.domain }}
storage: 2Gi
siteName: Chamilo LMS
adminUser: admin
adminEmail: '{{ .operator.email }}'
db:
host: '{{ .apps.mysql.host }}'
port: '3306'
name: chamilo
user: chamilo
smtp:
host: '{{ .apps.smtp.host }}'
port: '{{ .apps.smtp.port }}'
from: '{{ .apps.smtp.from }}'
user: '{{ .apps.smtp.user }}'
defaultSecrets:
- key: adminPassword
- key: dbPassword
- key: smtpPassword
requiredSecrets:
- mysql.rootPassword

View File

@@ -0,0 +1,4 @@
apiVersion: v1
kind: Namespace
metadata:
name: {{ .namespace }}

View File

@@ -0,0 +1,11 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: chamilo-data
namespace: {{ .namespace }}
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: {{ .storage }}

View File

@@ -0,0 +1,13 @@
apiVersion: v1
kind: Service
metadata:
name: chamilo
namespace: {{ .namespace }}
spec:
selector:
component: web
ports:
- name: http
port: 80
targetPort: 80
protocol: TCP

View File

@@ -0,0 +1,7 @@
name: community-search
is: community-search
description: Community Search is a federated, self-hosted search engine built on community-curated indexes rather than global web crawling.
category: community
latest: "0"
ignoreRules:
- WC-ICON # no established icon available

View File

@@ -0,0 +1,84 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: community-search
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
component: web
template:
metadata:
labels:
component: web
spec:
securityContext:
runAsNonRoot: true
runAsUser: 999
runAsGroup: 999
fsGroup: 999
seccompProfile:
type: RuntimeDefault
containers:
- name: community-search
image: payneio/community-search:0.1.2
imagePullPolicy: Always
securityContext:
allowPrivilegeEscalation: false
capabilities:
drop:
- ALL
readOnlyRootFilesystem: false
ports:
- name: http
containerPort: 8080
env:
- name: COMMUNITY_SEARCH_BIND_ADDR
value: "0.0.0.0"
- name: COMMUNITY_SEARCH_PORT
value: "8080"
- name: COMMUNITY_SEARCH_DATA_DIR
value: "/data"
- name: COMMUNITY_SEARCH_INDEX_PATH
value: "/data/index"
- name: COMMUNITY_SEARCH_ADMIN_TOKEN
valueFrom:
secretKeyRef:
name: community-search-secrets
key: adminToken
- name: SELF_URL
value: "{{ .selfUrl }}"
- name: SELF_NAME
value: "{{ .selfName }}"
- name: RUST_LOG
value: "community_search=info,tower_http=warn"
volumeMounts:
- name: data
mountPath: /data
resources:
requests:
cpu: 50m
memory: 256Mi
limits:
cpu: 1
memory: 1Gi
readinessProbe:
httpGet:
path: /api/collections
port: http
initialDelaySeconds: 10
periodSeconds: 10
timeoutSeconds: 5
livenessProbe:
httpGet:
path: /api/collections
port: http
initialDelaySeconds: 30
periodSeconds: 30
timeoutSeconds: 5
volumes:
- name: data
persistentVolumeClaim:
claimName: community-search-data

View File

@@ -0,0 +1,17 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: community-search
spec:
ingressClassName: traefik
rules:
- host: {{ .domain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: community-search
port:
number: 80

View File

@@ -0,0 +1,15 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: community-search
labels:
- includeSelectors: true
pairs:
app: community-search
managedBy: kustomize
partOf: wild-cloud
resources:
- namespace.yaml
- deployment.yaml
- service.yaml
- ingress.yaml
- pvc.yaml

View File

@@ -0,0 +1,9 @@
version: 0.1.2_1-1
defaultConfig:
namespace: community-search
domain: search.{{ .cloud.domain }}
storage: 2Gi
selfUrl: https://search.{{ .cloud.domain }}
selfName: Community Search
defaultSecrets:
- key: adminToken

View File

@@ -0,0 +1,4 @@
apiVersion: v1
kind: Namespace
metadata:
name: "{{ .namespace }}"

View File

@@ -0,0 +1,10 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: community-search-data
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: {{ .storage }}

View File

@@ -0,0 +1,13 @@
apiVersion: v1
kind: Service
metadata:
name: community-search
spec:
type: ClusterIP
ports:
- name: http
port: 80
protocol: TCP
targetPort: 8080
selector:
component: web

View File

@@ -1,5 +1,6 @@
name: coredns name: coredns
is: coredns is: coredns
description: DNS server for internal cluster DNS resolution description: DNS server for internal cluster DNS resolution
category: infrastructure category: services
icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/coredns.svg
latest: "v1" latest: "v1"

View File

@@ -1,4 +1,4 @@
version: v1.12.0 version: v1.12.0-1
requires: requires:
- name: metallb - name: metallb
defaultConfig: defaultConfig:

View File

@@ -1,5 +1,6 @@
name: crowdsec name: crowdsec
is: crowdsec is: crowdsec
description: CrowdSec security engine with Traefik bouncer for threat detection and rate limiting description: CrowdSec security engine with Traefik bouncer for threat detection and rate limiting
category: infrastructure category: services
icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/crowdsec.svg
latest: "v1" latest: "v1"

View File

@@ -60,7 +60,7 @@ spec:
- name: LEVEL_INFO - name: LEVEL_INFO
value: "true" value: "true"
- name: AGENT_USERNAME - name: AGENT_USERNAME
value: "kubernetes-cluster" value: "{{ if .agentUsername }}{{ .agentUsername }}{{ else }}kubernetes-cluster{{ end }}"
- name: AGENT_PASSWORD - name: AGENT_PASSWORD
valueFrom: valueFrom:
secretKeyRef: secretKeyRef:
@@ -72,6 +72,12 @@ spec:
name: crowdsec-secrets name: crowdsec-secrets
key: bouncerApiKey key: bouncerApiKey
optional: true optional: true
{{ if .centralLapiUrl }}
- name: DISABLE_LOCAL_API
value: "true"
- name: LOCAL_API_URL
value: "{{ .centralLapiUrl }}"
{{ end }}
ports: ports:
- name: lapi - name: lapi
containerPort: 8080 containerPort: 8080
@@ -79,6 +85,7 @@ spec:
- name: prometheus - name: prometheus
containerPort: 6060 containerPort: 6060
protocol: TCP protocol: TCP
{{ if not .centralLapiUrl }}
livenessProbe: livenessProbe:
httpGet: httpGet:
path: /health path: /health
@@ -91,9 +98,10 @@ spec:
port: 8080 port: 8080
initialDelaySeconds: 10 initialDelaySeconds: 10
periodSeconds: 10 periodSeconds: 10
{{ end }}
resources: resources:
requests: requests:
cpu: 100m cpu: 50m
memory: 200Mi memory: 200Mi
limits: limits:
cpu: 500m cpu: 500m

View File

@@ -1,4 +1,4 @@
version: v1.7.8 version: v1.7.8-4
requires: requires:
- name: longhorn - name: longhorn
- name: traefik - name: traefik
@@ -6,6 +6,8 @@ defaultConfig:
namespace: crowdsec namespace: crowdsec
rateLimitAverage: "100" rateLimitAverage: "100"
rateLimitBurst: "100" rateLimitBurst: "100"
centralLapiUrl: ""
agentUsername: ""
defaultSecrets: defaultSecrets:
- key: agentPassword - key: agentPassword
- key: bouncerApiKey - key: bouncerApiKey

View File

@@ -12,7 +12,7 @@ spec:
plugin: plugin:
bouncer: bouncer:
crowdsecLapiScheme: http crowdsecLapiScheme: http
crowdsecLapiHost: crowdsec-lapi.crowdsec.svc.cluster.local:8080 crowdsecLapiHost: {{ if .centralLapiUrl }}{{ strings.TrimPrefix "http://" .centralLapiUrl }}{{ else }}crowdsec-lapi.crowdsec.svc.cluster.local:8080{{ end }}
crowdsecLapiKeyFile: /etc/traefik/crowdsec/api-key crowdsecLapiKeyFile: /etc/traefik/crowdsec/api-key
crowdsecMode: stream crowdsecMode: stream
updateIntervalSeconds: 15 updateIntervalSeconds: 15
@@ -48,7 +48,6 @@ spec:
browserXssFilter: true browserXssFilter: true
contentTypeNosniff: true contentTypeNosniff: true
forceSTSHeader: true forceSTSHeader: true
frameDeny: true
sslRedirect: true sslRedirect: true
stsIncludeSubdomains: true stsIncludeSubdomains: true
stsPreload: true stsPreload: true
@@ -62,11 +61,17 @@ spec:
- OPTIONS - OPTIONS
accessControlAllowOriginList: accessControlAllowOriginList:
- "*" - "*"
accessControlAllowHeaders:
- X-Requested-With
- Content-Type
- Authorization
- Date
accessControlMaxAge: 100 accessControlMaxAge: 100
customRequestHeaders: customRequestHeaders:
X-Forwarded-Proto: https X-Forwarded-Proto: https
customResponseHeaders: customResponseHeaders:
Server: "" Server: ""
X-Frame-Options: SAMEORIGIN
X-Robots-Tag: noindex,nofollow,nosnippet,noarchive,notranslate,noimageindex X-Robots-Tag: noindex,nofollow,nosnippet,noarchive,notranslate,noimageindex
--- ---
apiVersion: traefik.io/v1alpha1 apiVersion: traefik.io/v1alpha1

6
cryptpad/app.yaml Normal file
View File

@@ -0,0 +1,6 @@
name: cryptpad
is: cryptpad
description: CryptPad is an end-to-end encrypted collaboration suite with documents, spreadsheets, kanban boards, and more.
category: productivity
icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/cryptpad.svg
latest: "2024"

25
cryptpad/notes.md Normal file
View File

@@ -0,0 +1,25 @@
# CryptPad — Notes
## Config directory requires emptyDir + initContainer
CryptPad's `/cryptpad/config/` directory is in the image overlay filesystem and is not writable
by the container process even when running as root.
**Fix**: mount an `emptyDir` at `/cryptpad/config` and use an initContainer to pre-seed
`config.example.js` from the image into the emptyDir:
```yaml
initContainers:
- name: seed-config
image: cryptpad/cryptpad:version-X.Y.Z
command: [sh, -c, "cp /cryptpad/config/config.example.js /config-dest/config.example.js"]
volumeMounts:
- name: cryptpad-config
mountPath: /config-dest
volumes:
- name: cryptpad-config
emptyDir: {}
```
Set `CPAD_CONF=/cryptpad/config/config.js` — the startup script copies `config.example.js` to
`config.js` on first run if `config.js` doesn't exist.

View File

@@ -0,0 +1,30 @@
# CryptPad
CryptPad is a privacy-first, end-to-end encrypted collaboration suite. Documents are encrypted in the browser before being stored — the server never sees plaintext content.
## Configuration
Key settings in `config.yaml`:
- **domain** - Main domain for CryptPad
- **sandboxDomain** - Sandbox subdomain for secure iframe isolation (default: `cryptpad-sandbox.{your-cloud-domain}`)
- **storage** - Persistent volume size (default: `2Gi`)
## Usage
No account is required to create documents. Just visit the app URL and start creating spreadsheets, code pads, presentations, or rich-text documents. Share the document URL with collaborators.
## Admin Setup
To access the admin panel, you need to register an account and then link it to the `adminKey` secret:
1. Register an account at the app URL
2. Go to your user settings and copy your **Public Signing Key**
3. The `adminKey` in `secrets.yaml` should match this key — it is pre-populated with a generated value, but you must replace it with your actual account's public signing key after registering
4. Once set, the **Admin** link will appear in the user menu
## Notes
- Both the main domain and the sandbox domain must be accessible — CryptPad uses the sandbox domain for secure iframe isolation, and the app will not function correctly if one is missing
- All encryption keys are generated client-side — if you lose your account passphrase, documents cannot be recovered
- The instance can be configured to require registration before creating documents (via the admin panel)

View File

@@ -0,0 +1,106 @@
apiVersion: apps/v1
kind: Deployment
metadata:
name: cryptpad
namespace: cryptpad
spec:
replicas: 1
strategy:
type: Recreate
selector:
matchLabels:
component: web
template:
metadata:
labels:
component: web
spec:
securityContext:
runAsUser: 0
runAsNonRoot: false
seccompProfile:
type: RuntimeDefault
initContainers:
- name: seed-config
image: cryptpad/cryptpad:version-2026.5.1
command:
- sh
- -c
- |
if [ ! -f /config-dest/config.example.js ]; then
cp /cryptpad/config/config.example.js /config-dest/config.example.js
fi
volumeMounts:
- name: cryptpad-config
mountPath: /config-dest
securityContext:
runAsNonRoot: false
runAsUser: 0
allowPrivilegeEscalation: false
capabilities:
drop: [ALL]
readOnlyRootFilesystem: false
seccompProfile:
type: RuntimeDefault
containers:
- name: cryptpad
image: cryptpad/cryptpad:version-2026.5.1
ports:
- name: http
containerPort: 3000
protocol: TCP
env:
- name: CPAD_CONF
value: /cryptpad/config/config.js
- name: CPAD_MAIN_DOMAIN
value: https://{{ .domain }}
- name: CPAD_SANDBOX_DOMAIN
value: https://{{ .sandboxDomain }}
- name: CPAD_TRUSTED_PROXY
value: "true"
resources:
limits:
cpu: 1000m
ephemeral-storage: 1Gi
memory: 1Gi
requests:
cpu: 50m
ephemeral-storage: 50Mi
memory: 256Mi
volumeMounts:
- name: cryptpad-data
mountPath: /cryptpad/data
- name: cryptpad-config
mountPath: /cryptpad/config
livenessProbe:
httpGet:
path: /
port: 3000
initialDelaySeconds: 90
timeoutSeconds: 5
periodSeconds: 15
failureThreshold: 6
readinessProbe:
httpGet:
path: /
port: 3000
initialDelaySeconds: 60
timeoutSeconds: 3
periodSeconds: 10
failureThreshold: 3
securityContext:
runAsNonRoot: false
runAsUser: 0
allowPrivilegeEscalation: false
capabilities:
drop: [ALL]
readOnlyRootFilesystem: false
seccompProfile:
type: RuntimeDefault
volumes:
- name: cryptpad-data
persistentVolumeClaim:
claimName: cryptpad-data
- name: cryptpad-config
emptyDir: {}
restartPolicy: Always

View File

@@ -0,0 +1,28 @@
apiVersion: networking.k8s.io/v1
kind: Ingress
metadata:
name: cryptpad
namespace: cryptpad
spec:
ingressClassName: traefik
rules:
- host: {{ .domain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: cryptpad
port:
number: 80
- host: {{ .sandboxDomain }}
http:
paths:
- path: /
pathType: Prefix
backend:
service:
name: cryptpad
port:
number: 80

View File

@@ -0,0 +1,15 @@
apiVersion: kustomize.config.k8s.io/v1beta1
kind: Kustomization
namespace: cryptpad
labels:
- includeSelectors: true
pairs:
app: cryptpad
managedBy: kustomize
partOf: wild-cloud
resources:
- namespace.yaml
- deployment.yaml
- service.yaml
- ingress.yaml
- pvc.yaml

View File

@@ -0,0 +1,8 @@
version: 2026.5.1-3
defaultConfig:
namespace: cryptpad
domain: cryptpad.{{ .cloud.domain }}
sandboxDomain: cryptpad-sandbox.{{ .cloud.domain }}
storage: 2Gi
defaultSecrets:
- key: adminKey

View File

@@ -0,0 +1,4 @@
apiVersion: v1
kind: Namespace
metadata:
name: {{ .namespace }}

View File

@@ -0,0 +1,11 @@
apiVersion: v1
kind: PersistentVolumeClaim
metadata:
name: cryptpad-data
namespace: cryptpad
spec:
accessModes:
- ReadWriteOnce
resources:
requests:
storage: {{ .storage }}

View File

@@ -0,0 +1,13 @@
apiVersion: v1
kind: Service
metadata:
name: cryptpad
namespace: cryptpad
spec:
selector:
component: web
ports:
- name: http
port: 80
targetPort: 3000
protocol: TCP

View File

@@ -1,5 +1,6 @@
name: decidim name: decidim
is: decidim is: decidim
description: Decidim is a participatory democracy framework for cities and organizations. Built in Ruby on Rails, it enables citizen participation through proposals, debates, and voting. Includes Sidekiq for background job processing. description: Decidim is a participatory democracy framework for cities and organizations. Built in Ruby on Rails, it enables citizen participation through proposals, debates, and voting. Includes Sidekiq for background job processing.
category: community
icon: https://raw.githubusercontent.com/decidim/decidim/develop/logo.svg icon: https://raw.githubusercontent.com/decidim/decidim/develop/logo.svg
latest: "0" latest: "0"

View File

@@ -95,7 +95,7 @@ spec:
valueFrom: valueFrom:
secretKeyRef: secretKeyRef:
name: decidim-secrets name: decidim-secrets
key: smtpPassword key: smtp.password
- name: SMTP_DOMAIN - name: SMTP_DOMAIN
value: {{ .domain }} value: {{ .domain }}
- name: SMTP_FROM - name: SMTP_FROM
@@ -136,9 +136,9 @@ spec:
ephemeral-storage: 10Gi ephemeral-storage: 10Gi
memory: 4Gi memory: 4Gi
requests: requests:
cpu: 500m cpu: 50m
ephemeral-storage: 50Mi ephemeral-storage: 50Mi
memory: 1Gi memory: 256Mi
volumeMounts: volumeMounts:
- name: decidim-data - name: decidim-data
mountPath: /code/public/uploads mountPath: /code/public/uploads
@@ -203,8 +203,8 @@ spec:
cpu: 1000m cpu: 1000m
memory: 2Gi memory: 2Gi
requests: requests:
cpu: 250m cpu: 50m
memory: 512Mi memory: 256Mi
volumeMounts: volumeMounts:
- name: decidim-data - name: decidim-data
mountPath: /code/public/uploads mountPath: /code/public/uploads

View File

@@ -4,15 +4,8 @@ kind: Ingress
metadata: metadata:
name: decidim name: decidim
namespace: decidim namespace: decidim
annotations:
external-dns.alpha.kubernetes.io/target: {{ .externalDnsDomain }}
external-dns.alpha.kubernetes.io/cloudflare-proxied: "false"
spec: spec:
ingressClassName: traefik ingressClassName: traefik
tls:
- hosts:
- {{ .domain }}
secretName: {{ .tlsSecretName }}
rules: rules:
- host: {{ .domain }} - host: {{ .domain }}
http: http:

View File

@@ -1,18 +1,14 @@
version: 0.31.0-1 version: 0.31.0-4
requires: requires:
- name: postgres - name: postgres
installed_as: postgres - name: redis
- name: redis - name: smtp
installed_as: redis
- name: smtp
defaultConfig: defaultConfig:
namespace: decidim namespace: decidim
externalDnsDomain: '{{ .cloud.domain }}' storage: 2Gi
storage: 20Gi
systemAdminEmail: '{{ .operator.email }}' systemAdminEmail: '{{ .operator.email }}'
siteName: 'Decidim' siteName: Decidim
domain: decidim.{{ .cloud.domain }} domain: decidim.{{ .cloud.domain }}
tlsSecretName: wildcard-wild-cloud-tls
db: db:
host: '{{ .apps.postgres.host }}' host: '{{ .apps.postgres.host }}'
port: '{{ .apps.postgres.port }}' port: '{{ .apps.postgres.port }}'
@@ -29,13 +25,14 @@ defaultConfig:
tls: '{{ .apps.smtp.tls }}' tls: '{{ .apps.smtp.tls }}'
startTls: '{{ .apps.smtp.startTls }}' startTls: '{{ .apps.smtp.startTls }}'
defaultSecrets: defaultSecrets:
- key: systemAdminPassword - key: systemAdminPassword
- key: secretKeyBase - key: secretKeyBase
default: "{{ random.AlphaNum 128 }}" default: '{{ random.AlphaNum 128 }}'
- key: smtpPassword - key: dbPassword
- key: dbPassword - key: dbUrl
- key: dbUrl default: postgres://{{ .app.db.user }}:{{ .secrets.dbPassword }}@{{ .app.db.host
default: "postgres://{{ .app.db.user }}:{{ .secrets.dbPassword }}@{{ .app.db.host }}:{{ .app.db.port }}/{{ .app.db.name }}" }}:{{ .app.db.port }}/{{ .app.db.name }}?sslmode=disable
requiredSecrets: requiredSecrets:
- postgres.password - postgres.password
- redis.password - redis.password
- smtp.password

View File

@@ -1,5 +1,6 @@
name: discourse name: discourse
is: discourse is: discourse
description: Discourse is a modern, open-source discussion platform designed for online communities and forums. description: Discourse is a modern, open-source discussion platform designed for online communities and forums.
category: community
icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/discourse.svg icon: https://cdn.jsdelivr.net/gh/homarr-labs/dashboard-icons/svg/discourse.svg
latest: "3" latest: "3"

View File

@@ -69,6 +69,7 @@ spec:
END IF; END IF;
END END
\$\$; \$\$;
ALTER USER $DISCOURSE_DB_USER WITH PASSWORD '$DISCOURSE_DB_PASSWORD';
GRANT ALL PRIVILEGES ON DATABASE $DISCOURSE_DB_NAME TO $DISCOURSE_DB_USER; GRANT ALL PRIVILEGES ON DATABASE $DISCOURSE_DB_NAME TO $DISCOURSE_DB_USER;
GRANT ALL ON SCHEMA public TO $DISCOURSE_DB_USER; GRANT ALL ON SCHEMA public TO $DISCOURSE_DB_USER;
GRANT USAGE ON SCHEMA public TO $DISCOURSE_DB_USER; GRANT USAGE ON SCHEMA public TO $DISCOURSE_DB_USER;

View File

@@ -185,9 +185,9 @@ spec:
ephemeral-storage: 10Gi ephemeral-storage: 10Gi
memory: 8Gi memory: 8Gi
requests: requests:
cpu: 750m cpu: 50m
ephemeral-storage: 50Mi ephemeral-storage: 50Mi
memory: 1Gi memory: 512Mi
volumeMounts: volumeMounts:
- name: discourse-data - name: discourse-data
mountPath: /shared mountPath: /shared
@@ -292,7 +292,7 @@ spec:
ephemeral-storage: 2Gi ephemeral-storage: 2Gi
memory: 1Gi memory: 1Gi
requests: requests:
cpu: 375m cpu: 50m
ephemeral-storage: 50Mi ephemeral-storage: 50Mi
memory: 512Mi memory: 512Mi
volumeMounts: volumeMounts:

View File

@@ -5,10 +5,8 @@ kind: Ingress
metadata: metadata:
name: discourse name: discourse
namespace: "{{ .namespace }}" namespace: "{{ .namespace }}"
annotations:
external-dns.alpha.kubernetes.io/cloudflare-proxied: "false"
external-dns.alpha.kubernetes.io/target: "{{ .externalDnsDomain }}"
spec: spec:
ingressClassName: traefik
rules: rules:
- host: "{{ .domain }}" - host: "{{ .domain }}"
http: http:
@@ -20,7 +18,3 @@ spec:
name: discourse name: discourse
port: port:
name: http name: http
tls:
- hosts:
- "{{ .domain }}"
secretName: wildcard-external-wild-cloud-tls

Some files were not shown because too many files have changed in this diff Show More