Nextcloud

High-Performance Nextcloud & MariaDB Deployment (CasaOS)
Status: Verified Deployment Environment: Ubuntu (CasaOS) | Synology DS1522+ Backend Core Architecture: Dedicated Mini PC for compute; "GoonersNAS" for muscle storage. 
 
 1. Preparation: The Network Bridge 
 To allow Nextcloud and MariaDB to communicate securely without using public IP addresses, they must reside on the same Docker network. 
 
 Network Name: big-bear-nextcloud-ls 
 Note: Ensure both containers are assigned to this network in their respective CasaOS settings to enable internal DNS resolution. 
 
 
 2. Database Setup (MariaDB) 
 We use the LinuxServer image for consistency and PUID/PGID support, which is vital for permission management. 
 
 
 
 Category 
 Setting / Value 
 
 
 
 
 Image 
 linuxserver/mariadb 
 
 
 Network 
 big-bear-nextcloud-ls 
 
 
 Port 
 Host 3306 -> Container 3306 
 
 
 Volume 
 /DATA/AppData/mariadb/config -> /config 
 
 
 
 Environment Variables: 
 MYSQL_ROOT_PASSWORD = [YourSecretRootPassword]
MYSQL_DATABASE = nextcloud
MYSQL_USER = nc_user
MYSQL_PASSWORD = [YourSecretUserPassword]
PUID = 1000
PGID = 1000
TZ = America/Chicago
 
 
 3. Application Setup (Nextcloud LS) 
 The Nextcloud LS (LinuxServer.io) version is preferred for its robust handling of PUID/PGID variables when mapping to NAS-based storage. 
 
 
 
 Category 
 Setting / Value 
 
 
 
 
 Image 
 linuxserver/nextcloud 
 
 
 Port 
 Host 10443 -> Container 443 
 
 
 Web UI 
 HTTPS (Required for Authentik) 
 
 
 Volume 1 
 /DATA/AppData/nextcloud/config -> /config 
 
 
 Volume 2 (NAS) 
 /mnt/synology/nextcloud_data -> /data 
 
 
 
 
 4. Initial Configuration (The Setup Screen) 
 Navigate to https://nc.goonersnas.com to complete the wizard. 
 
 Admin Account: Create a master local admin. 
 Storage & Database: Select MySQL/MariaDB . 
 Database User: nc_user 
 Database Host: mariadb:3306 
 
 
 5. Troubleshooting & Critical Fixes 
 
 The "Access Denied" Loop: If the installer rejects your credentials, MariaDB likely initialized with old variables. Fix: Stop MariaDB, delete all contents of /DATA/AppData/mariadb/config , and restart. It will re-generate the database with the correct PUID/PGID and credentials. 
 
 
 The "App Unavailable" Error: This is a protocol mismatch in CasaOS. Fix: Manually use https:// in the browser and update the App Settings to use the HTTPS dropdown. 
 
 
 6. Post-Install Checklist 
 
 [ ] Enable External Storage Support for Synology integration. 
 [ ] Install Social Login for Authentik OIDC. 
 [ ] Download ONLYOFFICE Desktop Editors for native local editing.

Installing ONLYOFFICE on Nextcloud (CasaOS/Ubuntu)
Overview 
 This guide covers deploying  ONLYOFFICE Document Server as a backend engine via CasaOS and integrating it with Nextcloud . This setup provides a high-performance office suite capable of handling Microsoft Office formats ( .docx , .xlsx , .pptx ) directly within the browser. 
 
 Prerequisites 
 
 Nextcloud running on Ubuntu (via Docker/CasaOS). 
 Reverse Proxy already configured for your main domain ( nc.goonersnas.com ). 
 A dedicated subdomain (e.g., office.goonersnas.com ) with an SSL certificate. 
 
 
 Step 1: Deploy ONLYOFFICE Document Server (Backend) 
 We use a separate Docker container for the rendering engine to ensure stability and performance. 
 
 Open CasaOS and click the + icon to install a customized app . 
 Click Import in the top right and paste the following Docker Compose snippet: 
 
 name: onlyoffice
services:
 onlyoffice:
 image: onlyoffice/documentserver:latest
 container_name: onlyoffice-docs
 environment:
 - JWT_ENABLED=true
 - JWT_SECRET=SecretGoonersKey123
 ports:
 - "8888:80"
 restart: unless-stopped
 
 
 Submit and Install . 
 Optional: Change the Network setting in CasaOS to match your Nextcloud bridge (e.g., big-bear-nextcloud-ls ). 
 
 
 Step 2: Reverse Proxy Configuration (Crucial) 
 To avoid the Mixed Active Content error, ONLYOFFICE must be served over HTTPS. 
 
 Point your subdomain (e.g., office.goonersnas.com ) to your server IP. 
 In your Reverse Proxy manager, create a new host:
 
 Domain: office.goonersnas.com 
 Forward IP: 192.168.0.152 
 Forward Port: 8888 
 
 
 Enable SSL and force SSL. 
 
 
 Step 3: Integration in Nextcloud 
 
 Install the App: Go to Apps > Office & text . Find ONLYOFFICE ,  click  Download,  and enable . 
 Configure Settings: 
 
 Go to Administration settings > ONLYOFFICE . 
 Document Editing Service address: https://office.goonersnas.com/ 
 Secret key: SecretGoonersKey123 
 Click Save . 
 
 
 
 
 IMPORTANT: If you see a red error banner stating "Mixed Active Content is not allowed," it means your Nextcloud ( https ) is trying to talk to an insecure ONLYOFFICE address ( http ). Always use the secure public subdomain URL in the Nextcloud settings to resolve this. 
 
 Verification 
 To verify the installation, navigate to your Files app and create a new Document . If the editor loads the Word-style interface, the integration is successful.