Skip to content

Manage access to Common and External ​

In Olares 1.12.7 and earlier, External and Common folders were accessible to all members. Starting with Olares 1.12.8, only the Super admin and Admins have access by default. Members need permission to view or edit these folders.

Use Access settings to grant members access to specific External mounts or Common folders.

Before you start ​

  • Log in to Olares as the Super admin or an admin who can manage the target folder.
  • For External storage, mount the storage before assigning permissions.

Supported folders ​

Permissions apply to the selected folder and all files and subfolders inside it. You cannot set separate permissions for individual subfolders. These settings control access through Files and do not change permissions on your NAS.

LocationFolder you can configureExample
A top-level folder in Common.Common/huggingface
A top-level mount in External: an SMB share, NFS share, USB drive, or local disk.

Note: The ai system folder is read-only for members and does not support access settings.
External/ProjectNAS

Role defaults and management scope ​

The following defaults apply to Common folders and External mounts.

Super admin (Owner)Full management accessAdmins and members
AdminFull management access, unless restricted by the Super adminMembers
MemberNo accessCannot change folder access settings

For more about Olares roles, see Roles and permissions.

Set folder permissions ​

  1. Log in to Olares as the Super admin or an admin who can manage the folder, then open Files.

  2. Go to Application > Common or Drive > External.

  3. Right-click the top-level folder or mounted directory, and select Access settings.

    Access settings in an External SMB folder context menu

  4. Find the person whose access you want to change and choose a permission. Only the Super admin can change an admin's folder permissions.

    No accessCannot see the folder or access its contents through Files.AvailableAvailable
    Can viewBrowse, preview, and download files.AvailableAvailable
    Can editView files and create, upload, modify, rename, or delete content inside the folder.AvailableAvailable
    AdminEdit content and manage the folder, including access settings. For External mounts, this also allows SMB sharing and unmounting.Not availableAvailable

    Only the Super admin can assign it.
  5. Click Confirm.

  6. Ask the person to refresh Files and check that the selected permission applies.

Change or revoke access ​

  1. Right-click the same folder and select Access settings.
  2. Change the user's permission. To revoke access for this user, select No access.
  3. Click Confirm.
  4. Ask the user to refresh Files and check that the new permission applies.

Revoking access does not delete the folder or its contents. It does not remove copies the user has already downloaded.

FAQs ​

How do folder access settings, Internal share, and SMB share differ, and when should I use each? ​

Choose based on where the folder is and how people will access it:

  • Access settings: Give users access to an External mount or a Common top-level folder. Users open the original folder directly under External or Common in Files.
  • Internal share: Share a Home or Sync folder with other Olares users. Recipients access the folder through a separate entry under Share in Files. External and Common do not support Internal share.
  • SMB share: Let computers access a Home or External folder over the local network, using Windows File Explorer or macOS Finder. When authentication is required, use dedicated SMB accounts, which are separate from Olares accounts.

Why can’t a member access or edit a folder? ​

Members cannot change these settings themselves. If a member reports a problem, sign in as the Super admin or an admin and check the following:

ProblemWhat to check
A folder is missing, or the member sees “No folders you can access.”Check the member's permission on the top-level folder or mount.
The member can read but cannot upload or edit.Check whether the permission is Can view. For NAS storage, also check that the NAS share allows writing.
Access settings is missing or
unavailable.
Make sure you selected a Common top-level folder or an External mount, and that your account can manage that folder.
Access stopped after an upgrade or a storage change.Check that the expected storage is mounted. Check the member’s access settings and grant access again if needed.

Learn more ​

  • Share files: Make folders available through Internal share, SMB share, or public links.
  • Mount an SMB share: Connect an existing SMB share from a NAS or server to Olares.