This repository was archived by the owner on Nov 26, 2025. It is now read-only.

Description
Background
While testing PosixFS support from PR #125, discovered configuration issues that could be prevented with better defaults and helpful comments in values.yaml.
Proposed Changes
1. Update default mount path
posixfs:
rootPath: "/mnt/posixfs" # Change from /var/lib/opencloud/storage to avoid OCM conflicts
2. Add helpful comments with links to docs
storage:
# Storage mode: "s3" (default) or "posixfs"
# For PosixFS documentation see: https://docs.opencloud.eu/docs/admin/configuration/storage/storage-posix/
mode: s3
posixfs:
# IMPORTANT: Path must be outside /var/lib/opencloud to avoid permission conflicts
# See: https://docs.opencloud.eu/docs/admin/configuration/storage/storage-posix/
rootPath: "/mnt/posixfs"
persistence:
enabled: true
size: 30Gi
# Tip: Can use different storage classes for cost optimization
# e.g., "ssd" for system data, "sata-large" for user files
storageClass: "standard"
3. Add short warning in README.md
## Storage Modes
### PosixFS
⚠️ **Important**: PosixFS requires exclusive filesystem access in non-collaborative mode (default).
Do not modify files directly while OpenCloud is running!
For details see: [OpenCloud PosixFS Documentation](https://docs.opencloud.eu/docs/admin/configuration/storage/storage-posix/)
Benefits
- Prevents common deployment errors (OCM permission issue)
- Links to authoritative documentation (no duplication)
- Inline hints for cloud provider optimization
- Keeps helm chart documentation minimal but helpful