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
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
2. Add helpful comments with links to docs
3. Add short warning in README.md
Benefits