Nextcloud improvements
This commit is contained in:
Astra Logical
parent
db75e2632e
commit
fa31265932
2 changed files with 84 additions and 103 deletions
|
|
@ -1,46 +0,0 @@
|
||||||
# Shelfmark — Track What You Read & Listen To
|
|
||||||
|
|
||||||
**Shelfmark** is a reading and listening tracker that integrates with [Calibre](https://calibre-ebook.com/) and [Audiobookshelf](../media-and-entertainment/audiobookshelf.md). It provides statistics, ratings, and a clean interface for managing your media consumption.
|
|
||||||
|
|
||||||
## Access
|
|
||||||
|
|
||||||
- **Web UI:** <https://magpie.mynest.love>
|
|
||||||
- **Internal (home network):** <http://shelfmark.k3s.home.nest>
|
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
- Track books and audiobooks across Calibre and Audiobookshelf libraries
|
|
||||||
- Rate and review items after finishing them
|
|
||||||
- View reading/listening statistics (books per month, genres, etc.)
|
|
||||||
- Sync progress with downstream services automatically
|
|
||||||
- OIDC integration — sign in with your Nest account
|
|
||||||
|
|
||||||
## Getting Started
|
|
||||||
|
|
||||||
1. Open <https://magpie.mynest.love> in your browser.
|
|
||||||
2. Click **Sign In** and choose **Sign in with The Nest**.
|
|
||||||
3. Shelfmark will automatically connect to your Calibre and Audiobookshelf libraries (if configured by admin).
|
|
||||||
4. Start rating and tracking your media!
|
|
||||||
|
|
||||||
## How It Works
|
|
||||||
|
|
||||||
Shelfmark connects to:
|
|
||||||
|
|
||||||
- **Calibre library** — Pulls book metadata, covers, and reading status
|
|
||||||
- **Audiobookshelf** — Syncs listening progress and ratings
|
|
||||||
- **Keycloak** — Handles authentication via passkeys
|
|
||||||
|
|
||||||
## Tips
|
|
||||||
|
|
||||||
- **Ratings sync:** Ratings you give in Shelfmark can be pushed back to Calibre/Audiobookshelf (if enabled).
|
|
||||||
- **Statistics:** Check the stats tab for insights into your reading habits — most-read authors, genres, and yearly summaries.
|
|
||||||
- **Offline access:** Shelfmark is web-only. For offline tracking, consider a dedicated app like [Readest](https://github.com/readest/readest) or [Foliate](https://github.com/johnfactotum/foliate).
|
|
||||||
|
|
||||||
## Related Services
|
|
||||||
|
|
||||||
- [Calibre-Web](../media-and-entertainment/calibre-web.md) — E-book library (Shelfmark reads from this data)
|
|
||||||
- [Audiobookshelf](../media-and-entertainment/audiobookshelf.md) — Audiobook server (Shelfmark syncs with this)
|
|
||||||
|
|
||||||
---
|
|
||||||
|
|
||||||
*TODO: Add screenshot of Shelfmark dashboard showing reading statistics.*
|
|
||||||
|
|
@ -1,61 +1,88 @@
|
||||||
# Nextcloud — File Sync, Sharing & Cloud Storage
|
# Nextcloud: Cloud Storage, Office Suite & Productivity Hub
|
||||||
|
|
||||||
**Nextcloud** is a self-hosted file sync and sharing platform. Store files, share them with others, and access them from any device — all under your control.
|
**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.
|
||||||
|
|
||||||
## Access
|
|
||||||
|
|
||||||
- **Web UI:** <https://cloud.mynest.love>
|
|
||||||
- **Internal (home network):** <http://nextcloud-app.nextcloud.svc.cluster.local>
|
|
||||||
- **DAV / CalDAV / CardDAV:** `https://cloud.mynest.love/remote.php/dav/`
|
|
||||||
|
|
||||||
## Features
|
|
||||||
|
|
||||||
- File storage and synchronization across devices
|
|
||||||
- Share files and folders via link or with specific users
|
|
||||||
- Integrated calendar (CalDAV) and contacts (CardDAV)
|
|
||||||
- Office suite integration for viewing and editing documents
|
|
||||||
- End-to-end encryption support (optional)
|
|
||||||
|
|
||||||
## Getting Started
|
|
||||||
|
|
||||||
1. Open <https://cloud.mynest.love> in your browser.
|
|
||||||
2. Click **Sign In** and choose **Sign in with The Nest**.
|
|
||||||
3. Upload files via the web interface or use a sync client.
|
|
||||||
|
|
||||||
## Sync Clients
|
|
||||||
|
|
||||||
Nextcloud provides official clients for:
|
|
||||||
|
|
||||||
- **Desktop:** Windows, macOS, Linux ([Download](https://nextcloud.com/install/#install-clients))
|
|
||||||
- **Mobile:** iOS and Android ([App Store](https://apps.nextcloud.com/))
|
|
||||||
- **WebDAV:** Configure any DAV-compatible app with the URL above
|
|
||||||
|
|
||||||
### Calendar & Contacts Sync
|
|
||||||
|
|
||||||
Add these to your device's calendar/contacts app:
|
|
||||||
|
|
||||||
| Type | Protocol | URL |
|
|
||||||
|------|----------|-----|
|
|
||||||
| Calendar | CalDAV | `https://cloud.mynest.love/remote.php/dav/principals/your-username/` |
|
|
||||||
| Contacts | CardDAV | `https://cloud.mynest.love/remote.php/dav/principals/your-username/` |
|
|
||||||
|
|
||||||
Sign in with your Nest credentials when prompted.
|
|
||||||
|
|
||||||
## Tips
|
|
||||||
|
|
||||||
- **File versioning:** Nextcloud keeps previous versions of files. Right-click a file → **Versions** to restore an older copy.
|
|
||||||
- **Sharing links:** Create shareable links with expiration dates and password protection for sensitive files.
|
|
||||||
- **Offline access:** Use the desktop sync client to keep a local copy of your files for offline work.
|
|
||||||
|
|
||||||
## Backups
|
|
||||||
|
|
||||||
Nextcloud user data is backed up daily at 02:00 EST using Restic to Backblaze B2. Configuration files are snapshotted via Longhorn's recurring backup jobs.
|
|
||||||
|
|
||||||
## Related Services
|
|
||||||
|
|
||||||
- [Keycloak](../technical/security-and-identity.md) — Handles authentication
|
|
||||||
- [Vaultwarden](../communication-and-security/vaultwarden.md) — Store Nextcloud credentials securely
|
|
||||||
|
|
||||||
---
|
---
|
||||||
|
|
||||||
*TODO: Add screenshot of Nextcloud file browser with a sample folder.*
|
## 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.
|
||||||
|
|
|
||||||
Loading…
Add table
Reference in a new issue