wehub-resource-sync
bcbd1bdb22
Integ / changes (push) Has been skipped
Pre-commit / pre-commit (push) Failing after 1s
CLI exit codes / changes (push) Has been skipped
Test (Install) / changes (push) Has been skipped
Test (Python) / changes (push) Has been skipped
Test (TypeScript) / changes (push) Has been skipped
CLI exit codes / cli-gate (push) Has been cancelled
Test (Install) / test-install-gate (push) Has been cancelled
Integ / integ-gate (push) Has been cancelled
Test (Python) / test-python-gate (push) Has been cancelled
Test (TypeScript) / test-typescript-gate (push) Has been cancelled
Test (Install) / python-minimal (3.12) (push) Has been cancelled
Test (Install) / python-minimal (3.11) (push) Has been cancelled
Test (Install) / python-extra (agno, mirage.agents.agno) (push) Has been cancelled
Test (Install) / python-extra (chroma, mirage.resource.chroma) (push) Has been cancelled
Test (Install) / python-extra (pdf, mirage.core.filetype.pdf) (push) Has been cancelled
Integ / integ (push) Has been cancelled
Integ / integ-database (push) Has been cancelled
Integ / integ-database-ts (push) Has been cancelled
Integ / integ-data (push) Has been cancelled
Integ / integ-ssh (push) Has been cancelled
Integ / integ-ssh-ts (push) Has been cancelled
Test (Python) / audit (push) Has been cancelled
Test (TypeScript) / test (push) Has been cancelled
Test (TypeScript) / python-fs-shim (push) Has been cancelled
CLI exit codes / Python CLI (push) Has been cancelled
CLI exit codes / TypeScript CLI (push) Has been cancelled
CLI exit codes / Cross-language snapshot interop (push) Has been cancelled
Test (Python) / test (push) Has been cancelled
Test (Python) / import-isolation (deepagents, openai, mirage.agents.openai_agents) (push) Has been cancelled
Test (Python) / import-isolation (deepagents, pydantic-ai, mirage.agents.pydantic_ai) (push) Has been cancelled
Integ / integ-ts (push) Has been cancelled
Integ / integ-fuse (push) Has been cancelled
Test (Install) / python-extra (databricks, mirage.resource.databricks_volume) (push) Has been cancelled
Test (Install) / python-extra (deepagents, mirage.agents.langchain) (push) Has been cancelled
Test (Install) / python-extra (email, mirage.resource.email) (push) Has been cancelled
Test (Install) / python-extra (fuse, mirage.fuse.mount) (push) Has been cancelled
Test (Install) / python-extra (hdf5, mirage.core.filetype.hdf5) (push) Has been cancelled
Test (Install) / python-extra (hf, mirage.resource.hf_buckets) (push) Has been cancelled
Test (Install) / python-extra (lancedb, mirage.resource.lancedb) (push) Has been cancelled
Test (Install) / python-extra (langfuse, mirage.resource.langfuse) (push) Has been cancelled
Test (Install) / python-extra (mongodb, mirage.resource.mongodb) (push) Has been cancelled
Test (Install) / python-extra (nextcloud, mirage.resource.nextcloud) (push) Has been cancelled
Test (Install) / python-extra (openai, mirage.agents.openai_agents) (push) Has been cancelled
Test (Install) / python-extra (openhands, mirage.agents.openhands, 3.12) (push) Has been cancelled
Test (Install) / python-extra (parquet, mirage.core.filetype.parquet) (push) Has been cancelled
Test (Install) / python-extra (postgres, mirage.resource.postgres) (push) Has been cancelled
Test (Install) / python-extra (pydantic-ai, mirage.agents.pydantic_ai) (push) Has been cancelled
Test (Install) / python-extra (qdrant, mirage.resource.qdrant) (push) Has been cancelled
Test (Install) / python-extra (redis, mirage.resource.redis) (push) Has been cancelled
Test (Install) / python-extra (s3, mirage.resource.s3) (push) Has been cancelled
Test (Install) / python-extra (ssh, mirage.resource.ssh) (push) Has been cancelled
Test (Install) / ts-minimal (push) Has been cancelled
58 lines
1.5 KiB
Plaintext
58 lines
1.5 KiB
Plaintext
---
|
|
title: Nextcloud
|
|
icon: cloud
|
|
description: Set up Nextcloud / ownCloud / WebDAV credentials for the Nextcloud resource.
|
|
---
|
|
|
|
## Overview
|
|
|
|
The Nextcloud resource talks to any [WebDAV](http://www.webdav.org/specs/rfc4918.html)
|
|
server: self-hosted Nextcloud, ownCloud, Hetzner Storage Share, or any
|
|
generic WebDAV endpoint. Authentication is HTTP Basic with an
|
|
**app password** (not your account password).
|
|
|
|
## Credentials
|
|
|
|
### 1. Pick a server
|
|
|
|
Any of these works:
|
|
|
|
- **Nextcloud Hosted trial** at https://try.nextcloud.com
|
|
- **Self-hosted**: `docker run -p 8080:80 nextcloud`
|
|
- **Hetzner Storage Share**, **ownCloud**, or any WebDAV server
|
|
|
|
### 2. Create an app password
|
|
|
|
In your Nextcloud web UI:
|
|
|
|
1. Open **Settings** → **Security** → **Devices & sessions**
|
|
2. Enter an app name (e.g. `mirage`) and click **Create new app password**
|
|
3. Copy the generated password (shown once)
|
|
|
|
Login password also works but **app passwords are strongly preferred** so
|
|
you can revoke per-app access without changing your account password.
|
|
|
|
### 3. Find your WebDAV URL
|
|
|
|
The standard Nextcloud path is:
|
|
|
|
```text
|
|
https://<your-server>/remote.php/dav/files/<username>/
|
|
```
|
|
|
|
For example: `https://cloud.example.com/remote.php/dav/files/alice/`.
|
|
|
|
For generic WebDAV servers, use whatever URL the provider gives.
|
|
|
|
### 4. Set environment variables
|
|
|
|
```bash
|
|
# .env.development
|
|
NEXTCLOUD_URL=https://cloud.example.com/remote.php/dav/files/alice/
|
|
NEXTCLOUD_USERNAME=alice
|
|
NEXTCLOUD_PASSWORD=<app-password>
|
|
```
|
|
|
|
For Python configuration, see the
|
|
[Nextcloud resource](/python/resource/nextcloud) docs.
|