# Nextcloud: Cloud Storage, Office Suite & Productivity Hub

**Nextcloud** (Nextcloud Hub) is the primary cloud storage, document collaboration, and groupware platform for **The Nest**. Far more than a simple file dump, Nextcloud combines cross-device file synchronization, real-time collaborative document editing, shared calendars, contacts, and productivity tools into a unified, privacy-focused portal.

---

## 1. Web Access & Initial Setup

1. Open **[cloud.mynest.love](https://cloud.mynest.love)** in your Web browser.
2. Click **Sign In** and select **"Sign in with The Nest"**.
3. Log in using your standard Nest passkey.

---

## 2. Core Features & Capabilities

* **File Storage & Synchronization:** Store files securely with continuous background sync across desktop and mobile devices.
* **File Versioning & Recovery:** Nextcloud automatically tracks file history. Right-click any file and select **Versions** to inspect or restore prior edits.
* **Secure File Sharing:** Share files and folders internally with Nest members or publicly via shareable links. Public shares can be secured with passwords, expiration dates, and download restrictions.
* **Project Management (Deck):** Organize team tasks and personal projects using built-in Kanban boards.
* **Activity Stream:** Track recent edits, file uploads, and comments across your shared folders in real time.

---

## 3. Nextcloud Office Suite (Collaborative Editing)

Nextcloud includes a full-featured, browser-based office suite (powered by Nextcloud Office) for working with documents, spreadsheets, and presentations:

* **Real-Time Co-Authoring:** Multiple users can open and edit the same document simultaneously with live cursor tracking, in-document chatting, and revision history.
* **Native Microsoft & OpenDocument Support:** Seamlessly view, edit, and export formats including Word (`.docx`, `.doc`), Excel (`.xlsx`, `.xls`), PowerPoint (`.pptx`), and OpenDocument (`.odt`, `.ods`, `.odp`).
* **In-Browser Document Creation:** Create new text documents, spreadsheets, or presentation decks directly from the Nextcloud **Files** interface without needing local office software installed.
* **Comments & Annotations:** Add comments, tag team members using `@mentions`, and track suggested changes directly within documents.
* **PDF Viewing & Annotation:** View, search, and annotate PDF files directly inside your browser window.

---

## 4. Calendar, Contacts & Tasks Integration (CalDAV / CardDAV)

Nextcloud provides built-in CalDAV and CardDAV endpoints for syncing your calendars, address books, and tasks across mobile and desktop applications.

> [!TIP]
> **Authentication Note for Native Apps (App Passwords)**
> Native calendar and contact apps on iOS, macOS, Android, or Thunderbird cannot use passkeys directly.
> 
> * Before configuring your app, go to **Settings → Security → Devices & Sessions** in Nextcloud.
> * Generate a new **App Password** (e.g., named "iPhone Calendar").
> * Copy the generated password and use it as your account password during device setup.

### Integration Endpoints & Manual Setup

| Type | Protocol | Base / Auto-Discovery URL | Direct Server Path |
| :--- | :--- | :--- | :--- |
| **Primary DAV Endpoint** | WebDAV / DAV | `https://cloud.mynest.love/remote.php/dav/` | Auto-discovers calendars & contacts |
| **Calendar (CalDAV)** | CalDAV | `https://cloud.mynest.love/remote.php/dav/` | `/remote.php/dav/principals/users/<your-username>/` |
| **Contacts (CardDAV)** | CardDAV | `https://cloud.mynest.love/remote.php/dav/` | `/remote.php/dav/principals/users/<your-username>/` |

### Setting Up Sync on Your Devices:
* **iOS / macOS:** Go to **System Settings → Internet Accounts → Add Account → Add Other Account → CalDAV Account (or CardDAV)**. Select **Advanced** and set the Server Address to `cloud.mynest.love` and the Server Path to `/remote.php/dav/principals/users/<your-username>/`. Alternatively, copy the exact subscription link by opening the Nextcloud **Calendar app → ⚙ Calendar settings → Copy iOS/macOS CalDAV address**.
* **Android:** Install **[DAVx⁵](https://www.davx5.com/)** from Google Play or F-Droid, choose **Login with URL and user name**, and enter `https://cloud.mynest.love/remote.php/dav/` alongside your username and App Password.
* **Thunderbird / Desktop:** Thunderbird autodiscovers all calendars and address books simply by adding a new Calendar and logging in with your Nextcloud URL and credentials.

*For detailed device-specific guides, consult the [Official Nextcloud Groupware Sync Documentation](https://docs.nextcloud.com/server/latest/user_manual/en/groupware/index.html).*

---

## 5. Sync Clients & Mobile Apps

* **Desktop Sync Client:** Sync local folders with Nextcloud on Windows, macOS, and Linux ([Download Clients](https://nextcloud.com/install/#install-clients)). Supports **Virtual Files** (files are visible locally but downloaded on demand to save disk space).
* **Mobile Apps (iOS & Android):** Browse files on the go and enable **Auto-Upload** in the app settings to automatically back up phone photos and videos directly to your Nextcloud cloud storage.

---

## 6. Service Summary & Infrastructure Notes

| Component | URL / Endpoint | Purpose |
| :--- | :--- | :--- |
| **Web UI** | [cloud.mynest.love](https://cloud.mynest.love) | Primary cloud portal, office suite, and web manager |
| **DAV / CalDAV / CardDAV** | `https://cloud.mynest.love/remote.php/dav/` | Synchronization endpoint for files, calendars, and contacts |

### Backups & Data Protection:
* **User Data:** Backed up daily at **02:00 EST** using Restic to offsite Backblaze B2 storage.
* **Configuration & Database:** Application state and cluster configurations are snapshotted via Longhorn recurring backup tasks.

---

## Related Nest Documentation:
* **[Forgejo](../technical/forgejo.md):** Git code hosting and package management.
* **[Matrix Chat](../communication-and-security/matrix.md):** Instant messaging and administrative support.