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
    No fields configured for issues without a type.

    Projects

    No projects

    Milestone

    No milestone

    Relationships

    None yet

    Development

    No branches or pull requests

    Issue actions