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

Improve PosixFS configuration defaults and add helpful comments #131

@michaelstingl

Description

@michaelstingl

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

Metadata

Metadata

Assignees

No one assigned

    Type

    No type

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions