How to Connect ONLYOFFICE Desktop Editors to an ownCloud Server

You can connect ONLYOFFICE Desktop Editors to an ownCloud server directly from the desktop application's Clouds section. The essential workflow is simple: add an ownCloud connection, enter the server URL, sign in on the ownCloud page that opens inside Desktop Editors, and then browse the Files area. The important condition is that the ownCloud side must already be prepared for ONLYOFFICE integration if you want collaborative editing rather than just a disconnected local-file workflow.

According to the current ONLYOFFICE documentation, the expected server-side setup includes an ownCloud server, ONLYOFFICE Docs, and the official ownCloud integration app. The ownCloud Marketplace currently lists the ONLYOFFICE connector as version 10.0.0, released September 15, 2026, with compatibility shown for ownCloud Classic 10–11. Because server and connector requirements can change, check the current compatibility information before upgrading either component. See the official ONLYOFFICE Desktop Editors ownCloud connection guide and the official ownCloud Marketplace listing for ONLYOFFICE.

When this setup is a good fit

This connection is useful when your organization already stores files in ownCloud but users prefer a desktop office suite for day-to-day editing. It gives Desktop Editors access to documents stored in ownCloud and can preserve collaborative capabilities when the server integration is configured correctly.

For example, imagine a small engineering team whose ownCloud address is https://cloud.example.com. The team keeps proposals, budgets, and presentation decks in shared folders. Each employee has ONLYOFFICE Desktop Editors installed on Windows, macOS, or Linux. Instead of downloading a DOCX file, editing a copy, and uploading it again, a user can connect Desktop Editors to the company's ownCloud instance and work from the cloud file list.

This example is illustrative, not a test result or customer claim. The exact experience depends on the versions, authentication policies, network routing, TLS certificates, and ownCloud permissions used by your organization.

What you need before connecting

• A working ownCloud account: you need a valid username or email address and password for the target server.
• The ownCloud server address: normally use the HTTPS URL users already open in a browser, such as https://cloud.example.com.
• ONLYOFFICE Desktop Editors: the application must already be installed on the computer.
• Network access: the computer running Desktop Editors must be able to reach the ownCloud server. An Internet connection is required when the server is remote and is also required for real-time co-editing.
• 서버 측 ONLYOFFICE 통합: ONLYOFFICE에서 문서화한 지원되는 통합 워크플로를 사용하려면 관리자는 ONLYOFFICE Docs와 공식 ownCloud 커넥터를 설치 및 구성해야 합니다.

ONLYOFFICE 통합 문서에는 ownCloud와 ONLYOFFICE Docs가 네트워크를 통해 서로 연결될 수 있어야 한다고 명시되어 있습니다. 서버 관리자의 경우, 공식 ONLYOFFICE ownCloud 통합 가이드에서 커넥터 및 문서 서버 요구 사항을 확인할 수 있습니다.

1단계: ONLYOFFICE 데스크톱 편집기에서 클라우드 섹션을 엽니다.

ONLYOFFICE 데스크톱 편집기를 실행하고 기본 애플리케이션 창으로 이동합니다. 최신 설명서에서는 연결된 서비스를 클라우드 영역에서 관리합니다. 클라우드 옆에 있는 더하기(+) 버튼을 클릭하거나 설치된 버전에 따라 클라우드 추가 옵션을 클릭합니다.

인터페이스에서 사용하는 용어가 약간 다를 경우, 타사 클라우드 서비스를 추가하는 섹션을 찾아보세요. 해당 위치는 릴리스마다 변경될 수 있지만, 공식적인 절차는 클라우드 연결 영역에서 ownCloud 계정을 추가하는 것을 중심으로 합니다.

2단계: 클라우드 서비스로 ownCloud를 선택하세요

사용 가능한 클라우드 제공업체 중에서 ownCloud를 선택하십시오 . ONLYOFFICE Desktop Editors는 여러 타사 서비스를 지원하므로, 이 통합 절차를 따를 때 Nextcloud 또는 일반 WebDAV 옵션이 아닌 ownCloud를 선택했는지 확인하십시오.

전용 ownCloud 항목을 사용하는 것이 중요한 이유는 문서화된 로그인 흐름 및 통합 동작이 일반 스토리지 연결이 아닌 ownCloud를 중심으로 설계되었기 때문입니다.

3단계: ownCloud 서버 URL을 입력합니다.

클라우드 오피스 URL 또는 서버 주소 필드 에 ownCloud 도메인 이름 또는 IP 주소를 입력하십시오. 예시에서는 값이 입니다 https://cloud.example.com. 운영 시스템의 경우 자격 증명 및 문서 트래픽이 암호화되지 않은 연결을 통해 전송되어서는 안 되므로 HTTPS를 사용하는 것이 강력히 권장됩니다.

그런 다음 [지금 연결]을 클릭합니다 . 서버가 하위 경로에 게시되었거나 역방향 프록시 뒤에 있는 경우 사용자의 컴퓨터에서 올바르게 확인되는 외부에서 접근 가능한 URL을 사용하십시오. 여기에 ONLYOFFICE 문서 서버 주소를 입력하지 마십시오. 이 필드는 사용자의 파일을 호스팅하는 ownCloud 서버를 위한 것입니다.

4단계: ownCloud 계정으로 로그인하세요.

연결이 시작되면 데스크톱 편집기 인터페이스 내 새 탭에 ownCloud 로그인 페이지가 열립니다. ownCloud에 사용하는 것과 동일한 사용자 이름 또는 이메일 주소와 비밀번호를 입력한 다음 로그인을 선택하세요 .

조직에서 사용자 지정 로그인 흐름, 싱글 사인온(SSO), 다단계 인증 또는 ID 프록시를 사용하는 경우 페이지가 표준 ownCloud 로그인 페이지와 다르게 보일 수 있습니다. 관리자가 승인한 인증 방법을 따르십시오. 내장된 로그인이 완료되지 않으면 데스크톱 편집기 설정을 변경하기 전에 동일한 계정으로 일반 브라우저에서 ownCloud URL에 로그인할 수 있는지 확인하십시오.

5단계: ownCloud가 연결된 클라우드로 표시되는지 확인합니다.

필요한 경우 데스크톱 편집기 기본 창으로 돌아가십시오. 클라우드 영역에 연결이 성공적으로 이루어졌다는 메시지가 표시됩니다. 이는 인증이 완료되었고 데스크톱 애플리케이션이 클라우드 연결을 저장했음을 확인하는 첫 번째 실질적인 방법입니다.

ownCloud가 표시되지 않으면 연결을 다시 시도하고 URL을 꼼꼼히 확인하십시오. 호스트 이름 오타, 접속할 수 없는 개인 주소, 차단된 포트 또는 인증서 문제로 인해 로그인 페이지가 제대로 로드되지 않을 수 있습니다.

6단계: 연결에 실패하면 서버 주소를 확인하십시오.

데스크톱 편집기에서 ownCloud에 연결할 수 없는 경우 연결 대화 상자를 다시 열고 서버 주소를 브라우저에서 작동하는 URL과 비교하십시오. 예를 들어 `/hostname/localhost`와 같이 전체 스키마와 호스트 이름을 사용하십시오 https://cloud.example.com. 컴퓨터에서 확인할 수 없는 경우 로컬 전용 호스트 이름은 입력하지 마십시오.

자체 호스팅 설치의 경우, 리버스 프록시가 운영 체제에서 신뢰하는 인증서를 제공하는지 확인하십시오. 자체 서명 또는 내부 발급 인증서를 사용하는 경우, 내장 인증이 안정적으로 작동하려면 조직의 신뢰할 수 있는 루트 인증서를 설치해야 할 수 있습니다.

7단계: 세션이 만료된 경우 다시 인증하세요.

클라우드 세션은 비밀번호 변경, 서버 업그레이드 또는 관리자 작업 후 만료되거나 무효화될 수 있습니다. 이러한 경우 동일한 문서를 반복해서 다시 열지 말고 다시 로그인하십시오. 현재 사용 중인 ownCloud 자격 증명을 사용하고 조직에서 요구하는 추가 인증 단계를 완료하십시오.

서버 URL에 비밀번호를 공유하거나 자격 증명을 포함시키지 마십시오. 문서화된 절차는 서버 주소와 ownCloud 로그인 페이지를 분리하므로 더 안전하고 일반적인 방식입니다.

8단계: ownCloud에서 파일을 열고 왕복 과정을 확인합니다.

로그인 후 ownCloud 파일 영역이 열립니다. 폴더를 찾아 편집 권한이 있는 간단한 테스트 문서를 엽니다. 간단한 수정을 하고 저장한 다음, ownCloud 웹 인터페이스 또는 다른 인증된 클라이언트에서 업데이트된 파일이 있는지 확인합니다.

이 왕복 검사는 로그인 화면에서 비밀번호가 제대로 입력되는지 여부만으로 성공 여부를 판단하는 것보다 더 나은 방법입니다. 인증, 파일 목록 보기, 파일 열기, 편집, 저장 등 모든 기능이 원활하게 작동하는지 확인해 줍니다.

연결된 계정을 관리하거나 삭제하는 방법

Desktop Editors 공식 설명서에 따르면 연결된 클라우드 계정은 왼쪽의 '클라우드' 영역에 표시됩니다. 계정 메뉴에는 '열기' , '로그아웃' , '목록에서 제거' 와 같은 옵션이 있습니다 . '로그아웃'은 현재 세션을 종료하고 나중에 다시 연결하려는 경우에 사용합니다. '목록에서 제거'는 Desktop Editors에서 계정 항목을 완전히 제거하려는 경우에 사용합니다.

클라우드 계정을 여러 개 추가할 수도 있습니다. 이는 여러 ownCloud 환경에서 작업하는 관리자나 컨설턴트에게 유용할 수 있지만, 잘못된 테넌트의 파일을 편집하지 않도록 워크플로에 레이블을 신중하게 지정해야 합니다.

일반적인 연결 문제와 그 의미

관리자를 위한 서버 측 검사

많은 사용자가 동시에 오류를 겪는 경우, 개별 데스크톱보다는 서버 측 문제일 가능성이 높습니다. ownCloud에서 공식 ONLYOFFICE 커넥터가 활성화되어 있고 올바른 ONLYOFFICE Docs 주소를 가리키는지 확인하십시오. ONLYOFFICE 설명서에 따르면 문서 서버는 ownCloud에서 확인 및 연결 가능해야 하며, ownCloud로 요청을 다시 보낼 수 있어야 합니다.

2026년 10월 7일 현재 ownCloud Marketplace에는 ONLYOFFICE 커넥터 버전 10.0.0이 최신 릴리스로 표시되어 있으며 ownCloud Classic 10~11과 호환된다고 나와 있습니다. 하지만 이는 특정 시점의 호환성 확인일 뿐이며 영구적인 규칙은 아닙니다. 업그레이드하기 전에 최신 Marketplace 릴리스 정보 와 ONLYOFFICE 통합 문서를 검토하십시오 .

설정이 제대로 작동하는지 어떻게 알 수 있을까요?

연결이 성공하려면 다음 네 가지 조건을 모두 충족해야 합니다. 데스크톱 편집기에서 ownCloud URL에 접속할 수 있어야 하고, 인증에 성공해야 하며, 허용된 폴더와 파일이 표시되어야 하고, 테스트 편집 내용을 ownCloud에 저장할 수 있어야 합니다. 이 네 가지 조건이 모두 충족되면 데스크톱에서 클라우드로의 연결이 정상적으로 작동하는 것입니다. 첫 번째와 두 번째 조건만 충족되는 경우, 데스크톱 애플리케이션을 반복적으로 재설치하기보다는 권한 설정 및 서버 측 통합 문제를 해결하는 데 집중해야 합니다.

예시 팀의 경우 https://cloud.example.com, 원하는 결과는 간단합니다. 사용자가 데스크톱 편집기를 열고 연결된 ownCloud 계정을 선택한 다음, 공유 프로젝트 폴더로 이동하여 문서를 편집하고 저장하면 ownCloud에서 업데이트된 파일이 반영되는 것입니다. 이것이 바로 이 설정이 팀의 워크플로에 적합한지 판단하는 실질적인 기준입니다.