# ownCloud Infinite Scale

> ownCloud Infinite Scale modern cloud storage.

- Category: Storage & Backup
- Difficulty: intermediate
- Components: owncloud-ocis
- Tags: owncloud, ocis, cloud, file-sync, storage
- Source: https://docker.recipes/storage/owncloud-infinite-scale

## Overview

ownCloud Infinite Scale (oCIS) represents a complete architectural reimagining of the traditional ownCloud platform, built from the ground up as a cloud-native, microservices-based file sync and sharing solution. Unlike the monolithic PHP-based ownCloud Server, oCIS is written in Go and designed around modern distributed systems principles, offering significantly improved performance, scalability, and resource efficiency. The platform provides enterprise-grade file synchronization, collaboration tools, and secure sharing capabilities while maintaining compatibility with existing ownCloud clients and workflows.

This Docker deployment leverages oCIS's containerized architecture to deliver a complete cloud storage platform in a single container. The microservices within oCIS communicate internally through gRPC and REST APIs, with the proxy service handling external HTTP requests and routing them to appropriate backend services like the storage provider, user management, and authentication services. The configuration utilizes oCIS's built-in identity management system and provides immediate access to features like WebDAV synchronization, web-based file management, and collaborative editing capabilities.

This stack is ideal for organizations seeking modern cloud storage infrastructure without the complexity of traditional enterprise solutions, developers building applications requiring file storage APIs, and system administrators looking to migrate from legacy file sharing platforms. The Go-based architecture provides superior performance characteristics compared to PHP-based alternatives, while the microservices design enables horizontal scaling and easier maintenance in production environments.

## Features

- Microservices architecture with gRPC inter-service communication for improved performance and scalability
- Built-in OpenID Connect provider with configurable user authentication and authorization
- WebDAV protocol support for seamless integration with desktop and mobile sync clients
- Integrated web interface with real-time collaboration features and file preview capabilities
- S3-compatible storage backend options with support for multiple storage providers
- WOPI integration for online document editing with supported office suites
- RESTful APIs for custom application integration and third-party service connectivity
- Event-driven architecture with configurable webhooks and notification systems

## Use cases

- Small to medium businesses requiring secure file sharing and collaboration without vendor lock-in
- Development teams needing private cloud storage with API integration for CI/CD workflows
- Educational institutions implementing student and faculty file sharing with access controls
- Remote organizations requiring centralized document management with offline synchronization
- System integrators building custom applications that need enterprise file storage backends
- IT departments migrating from legacy Dropbox or Google Drive deployments to self-hosted solutions
- Startups requiring scalable file storage infrastructure that can grow with their user base

## Prerequisites

- Docker Engine 20.10+ and Docker Compose V2 for container orchestration support
- Minimum 2GB RAM and 2 CPU cores for stable oCIS microservices operation
- Available port 9200 for HTTPS web interface and API access
- Valid SSL certificate or acceptance of self-signed certificate warnings in browsers
- Understanding of OpenID Connect authentication flows for user management configuration
- Basic knowledge of WebDAV protocols for client synchronization setup

## docker-compose.yml

```yaml
services:
  ocis:
    image: owncloud/ocis:latest
    container_name: ocis
    restart: unless-stopped
    ports:
      - "${OCIS_PORT:-9200}:9200"
    environment:
      - OCIS_URL=https://${OCIS_DOMAIN:-localhost}:9200
      - PROXY_HTTP_ADDR=0.0.0.0:9200
      - OCIS_INSECURE=true
      - IDM_ADMIN_PASSWORD=${ADMIN_PASSWORD:-admin}
      - OCIS_LOG_LEVEL=info
    volumes:
      - ocis_data:/var/lib/ocis
    networks:
      - ocis-network

volumes:
  ocis_data:

networks:
  ocis-network:
    driver: bridge
```

## .env

```bash
# ownCloud Infinite Scale
OCIS_PORT=9200
OCIS_DOMAIN=localhost
ADMIN_PASSWORD=admin
```

## Usage notes

- oCIS at https://localhost:9200
- Accept self-signed cert warning
- Login: admin/admin
- Modern rewrite of ownCloud

## Troubleshooting

- Certificate warnings in browser: Set OCIS_INSECURE=false and configure proper TLS certificates with valid domain names
- Admin login fails with default credentials: Check ADMIN_PASSWORD environment variable is properly set and container has restarted
- Port 9200 connection refused: Verify port is not in use by other services and firewall allows inbound connections
- File uploads failing or timing out: Increase Docker container memory limits and check available disk space for ocis_data volume
- WebDAV sync clients cannot connect: Ensure OCIS_URL matches the actual domain/IP clients use to access the service
- Microservices startup errors in logs: Check that all required environment variables are set and container has sufficient resources allocated

