How to Mount S3-Compatible Storage as External Storage in Nextcloud

To mount an S3-compatible bucket in Nextcloud, enable the built-in External storage support app, add an Amazon S3 storage entry in the administrator’s External storage settings, and supply the bucket credentials plus the provider’s endpoint details. Nextcloud uses the Amazon S3 backend for compatible services; you do not need to install a separate app for each S3 vendor. The exact hostname, region, and path-style setting depend on the object-storage provider.

This guide follows the current Nextcloud administration documentation for the S3 and external-storage backends, checked October 6, 2026. The labels may differ slightly between server versions and themes. A mount can be reachable while still behaving differently from a local Nextcloud folder, especially when files are changed directly in the bucket.

What should you check before adding the bucket?

Confirm these details with your S3 provider before opening Nextcloud settings:

• The bucket name and the credentials for an access key.
• The provider’s generic S3 endpoint hostname, such as s3.example.net. Use the endpoint itself, not a bucket-specific URL that already contains the bucket name.
• The region or signing region if the provider requires one.
• Whether requests should use virtual-hosted style (https://bucket.endpoint/) or path style (https://endpoint/bucket).
• The HTTPS port, normally 443, and whether your server can reach that endpoint through its firewall and DNS.

Create a dedicated access key for this mount and limit its permissions to the bucket and actions it needs. Do not paste secrets into a ticket, screenshot, or shell history. Nextcloud’s S3 setup requires an access key ID and secret access key; it does not validate every provider-specific permission policy for you.

Is this the same as making S3 Nextcloud’s primary storage?

No. An external-storage mount exposes an existing bucket as a folder inside Nextcloud. It is useful when you want to browse or manage files in a bucket while keeping the bucket accessible to other S3 tools. Primary object storage is a different server-wide architecture with different operational assumptions. If you need to choose between them, review Nextcloud’s primary object storage documentation before changing a production data design.

How do you add the S3-compatible mount in the web interface?

1. Enable External storage support

Sign in as a Nextcloud administrator, open Apps, and enable the bundled External storage support app. It is included with Nextcloud but may be disabled by default. If it is already enabled, continue to the storage settings.

2. Open the administrator’s External storage page

프로필 메뉴를 열고 설정을 선택한 다음 관리 섹션에서 외부 저장소를 찾으세요 . 이 페이지는 관리자가 구성한 마운트를 위한 페이지입니다. 개별 사용자가 개인 설정에서 구성한 저장소는 해당 사용자만 사용할 수 있지만, 관리자 마운트는 선택한 사용자 및 그룹에게만 제공될 수 있습니다.

3. 마운트를 생성하고 S3 백엔드를 선택합니다.

새 행에 간단한 폴더 이름을 입력하세요 (예: Archive). 이 이름은 Nextcloud에 표시되는 폴더 이름이 되며 경로가 아닌 이름이어야 합니다. 슬래시(/)를 포함하지 마세요. 저장소 유형 선택기에서 Amazon S3를 선택합니다 . 인증에서 액세스 키를 선택합니다 .

4. 버킷과 자격 증명을 입력합니다.

제공업체에서 제공한 정확한 버킷 이름, 액세스 키 ID 및 비밀 액세스 키를 입력하십시오. 비밀 키는 암호처럼 취급해야 합니다. Nextcloud 설명서에 따르면 이 백엔드의 버킷 이름은 서비스가 다른 곳에서 호스팅되는 경우에도 AWS S3 명명 규칙을 준수해야 하며, 밑줄(_)은 허용되지 않습니다. 제공업체의 버킷 이름에 밑줄이 포함된 경우, 자격 증명 문제를 해결하기 전에 제공업체에서 호환되는 버킷 이름을 제공하는지 확인하십시오.

5. 엔드포인트, 지역 및 요청 스타일을 설정합니다.

Amazon에서 호스팅하는 S3의 경우 올바른 지역을 지정하십시오. Amazon 이외의 서비스를 사용하는 경우 공급자의 일반 호스트 이름을 설정하십시오. 공급자가 게시한 엔드포인트 및 지역 값을 사용하십시오. 모든 S3 호환 제품에 적용되는 공통 지역 값은 없습니다.

Nextcloud의 최신 S3 가이드에서는 Amazon이 아닌 스토리지를 사용할 경우 일반 엔드포인트 호스트 이름을 사용하라고 명시적으로 안내하고 있습니다. 또한 경로 스타일 주소 지정 방식은 공급자에 따라 다르므로, 공급자의 S3 문서에서 예상되는 주소 지정 방식을 확인할 수 있다면 경로 스타일을 임의로 변경하지 말라고 설명합니다.

6. 마운트 사용 권한을 제한하세요

' 사용 가능 대상' 옵션을 사용하여 의도한 Nextcloud 사용자 또는 그룹에게만 접근 권한을 할당하세요. 그렇지 않으면 관리자가 구성한 마운트가 광범위하게 접근 가능하게 될 수 있습니다. 또한 저장 후 마운트 옵션을 확인하세요. 아카이브 또는 공유 버킷의 경우 읽기 전용 모드 및 공유 제어가 적절할 수 있습니다. 공유 동작은 Nextcloud를 통해 파일을 공개할 수 있는 사용자에게 영향을 미칠 수 있으므로 신중하게 설정해야 합니다.

7. Nextcloud가 연결되는지 확인하십시오.

필수 입력값이 모두 유효하면 스토리지 행이 자동으로 저장됩니다. 상태 표시기가 녹색이면 Nextcloud에서 구성된 스토리지를 사용할 수 있음을 의미하고, 빨간색 또는 노란색이면 연결 또는 구성에 문제가 있음을 나타냅니다. 관리자 페이지에서 스토리지 오류 발생 시 10분 동안 일시적으로 사용 불가로 표시될 수 있습니다. 해당 상태 아이콘을 클릭하거나 페이지를 새로 고침하여 값을 수정한 후 다시 확인하십시오.

8. 무해한 파일로 테스트해 보세요.

마운트된 영역에 접근 권한이 있는 사용자로 파일 탐색기를 엽니다 . 폴더가 나타나는지 확인하고, 작은 테스트 파일을 생성하거나 업로드한 후 다시 다운로드합니다. 버킷이 쓰기 가능해야 하는 경우, 해당 파일을 삭제합니다. 마운트가 읽기 전용이어야 하는 경우, 사용자가 파일을 읽을 수 있는지 확인하고 쓰기가 차단되는지 검증합니다. 녹색 표시등만으로는 모든 사용자 권한 또는 의도된 읽기/쓰기 동작이 올바르다고 보장할 수 없습니다.

명령줄에서 마운트 상태를 어떻게 확인할 수 있나요?

서버를 직접 관리하는 설치 환경의 경우, Nextcloud는 occ외부 저장소에 대한 명령도 제공합니다. Nextcloud 설치 디렉터리에서 명령을 실행하고 시스템에 맞는 웹 서버 계정을 사용하십시오. 대부분의 Linux 설치 환경에서는 `<server>`가 `<server>`이지만 www-data, 패키지 및 컨테이너 설치 환경에 따라 다를 수 있습니다.

sudo -E -u www-data php occ files_external:list
sudo -E -u www-data php occ files_external:verify <mount_id>

<mount_id>`list` 명령에 표시된 ID로 교체하십시오 . 확인이 성공하면 Nextcloud가 해당 시점에 구성된 연결을 설정할 수 있음을 의미합니다. Nextcloud AIO 또는 다른 컨테이너 배포의 경우, occ호스트 명령을 그대로 복사하는 대신 해당 배포에서 제공하는 앱 컨테이너 내부 실행 방법을 사용하십시오.

값이 제대로 입력된 것처럼 보이는데도 마운트가 실패하는 이유는 무엇일까요?

서비스가 자체 서명 인증서를 사용하는 경우 서버는 해당 인증서를 신뢰해야 합니다. 인증서 검증을 비활성화하는 것은 안전한 대안이 아닙니다. Nextcloud의 최신 설명서에는 와 같은 반복되는 구분 기호가 Photos//cat.png지원되지 않으며 영향을 받는 접두사가 무시될 수 있다는 경고도 포함되어 있습니다.

버킷 내의 파일이 직접 변경되면 어떻게 되나요?

Nextcloud는 외부 저장소에 대한 내부 파일 캐시를 유지합니다. 다른 도구가 S3에서 객체를 직접 추가, 편집 또는 삭제하는 경우 Nextcloud에서 변경 사항을 즉시 인식하지 못할 수 있습니다. 현재 외부 저장소 가이드에서는 푸시 알림이 없는 저장소 유형의 경우 주기적인 재스캔을 권장합니다. 마운트 ID는 다음 명령을 files_external:list실행하여 확인할 수 있습니다.

sudo -E -u www-data php occ files_external:scan <mount_id>

필요한 최신 상태 유지 시점과 서버 부하에 맞춰 스캔 일정을 예약하세요. 스캔은 즉각적인 변경 알림과는 다릅니다. Nextcloud는 메타데이터 위험성을 명시하고 있습니다. 외부에서 이름을 변경하면 재스캔 시 기존 객체가 삭제되고 새 객체가 추가된 것으로 인식되어 기존 항목과 관련된 Nextcloud 측 공유, 태그, 댓글, 활동 기록 등이 삭제될 수 있습니다. 따라서 메타데이터 보존이 중요한 경우에는 Nextcloud를 통해 이름을 변경하는 것이 좋습니다.

설치가 완료되었는지 어떻게 알 수 있나요?

• S3 마운트는 관리자의 외부 저장소 페이지에서 녹색 상태로 표시됩니다.
• 지정된 그룹에 속한 사용자는 마운트를 볼 수 있지만, 지정되지 않은 사용자는 볼 수 없습니다.
• 테스트 업로드, 다운로드 및 삭제는 의도한 대로 작동하거나, 읽기 전용 마운트의 경우 쓰기 작업이 차단됩니다.
• 서버는 설정된 스캔 간격 이후에 Nextcloud 외부에서 발생한 변경 사항을 감지할 수 있습니다.
• 자격 증명은 Nextcloud 구성 및 공급자 계정에만 저장되며, 액세스는 필요한 버킷으로 제한됩니다.

버전별 세부 정보는 Nextcloud S3 외부 스토리지 가이드 , 외부 스토리지 관리 가이드 및 공식 occ 명령어 참조 문서를 확인하세요 . 제공업체마다 엔드포인트, 지역, 권한 및 주소 지정 요구 사항이 다르므로 해당 값에 대해서는 각 제공업체의 S3 설정 문서를 참조하는 것이 가장 좋습니다.