WOPI (Office Document Editing)

OxiCloud integrates with Collabora Online and OnlyOffice via the WOPI protocol, letting users edit documents, spreadsheets, and presentations directly in the browser.

How It Works

1. User opens a document (.docx, .xlsx, .pptx, .odt, etc.)
2. OxiCloud generates a WOPI access token and redirects to the editor
3. The editor fetches the file from OxiCloud via WOPI endpoints
4. Edits are saved back via PutFile

Configuration

OXICLOUD_WOPI_ENABLED=true
OXICLOUD_WOPI_DISCOVERY_URL="http://collabora:9980/hosting/discovery"

Variable	Default	Description
OXICLOUD_WOPI_ENABLED	false	Enable WOPI integration
OXICLOUD_WOPI_DISCOVERY_URL	—	Editor's WOPI discovery URL
OXICLOUD_WOPI_SECRET	(JWT secret)	Token signing key
OXICLOUD_WOPI_TOKEN_TTL_SECS	86400	Access token lifetime
OXICLOUD_WOPI_LOCK_TTL_SECS	1800	Lock expiration

Docker Compose with Collabora

services:
  collabora:
    image: collabora/code:latest
    environment:
      - domain=oxicloud\\.example\\.com
      - extra_params=--o:ssl.enable=false
    ports:
      - "9980:9980"
    cap_add:
      - MKNOD

  oxicloud:
    environment:
      OXICLOUD_WOPI_ENABLED: "true"
      OXICLOUD_WOPI_DISCOVERY_URL: "http://collabora:9980/hosting/discovery"

Docker Compose with OnlyOffice

services:
  onlyoffice:
    image: onlyoffice/documentserver:latest
    environment:
      - JWT_ENABLED=false
    ports:
      - "8443:443"

  oxicloud:
    environment:
      OXICLOUD_WOPI_ENABLED: "true"
      OXICLOUD_WOPI_DISCOVERY_URL: "http://onlyoffice/hosting/discovery"

WOPI Endpoints

Method	Endpoint	Description
GET	/wopi/files/{id}	CheckFileInfo — file metadata
GET	/wopi/files/{id}/contents	GetFile — download file content
POST	/wopi/files/{id}/contents	PutFile — save edited content
POST	/wopi/files/{id}	Lock / Unlock / RefreshLock

Supported Formats

Any format supported by your Collabora or OnlyOffice installation, typically:

• Documents: .docx, .odt, .doc, .rtf
• Spreadsheets: .xlsx, .ods, .xls, .csv
• Presentations: .pptx, .odp, .ppt