Skip to content

docs(self-hosting): document the WebDAV media source - #33

Open
obelix58143 wants to merge 1 commit into
trypostit:mainfrom
obelix58143:docs/webdav-media-source-v2
Open

obelix58143 wants to merge 1 commit into
trypostit:mainfrom
obelix58143:docs/webdav-media-source-v2

Conversation

@obelix58143

Copy link
Copy Markdown

Documents the WebDAV media source from trypostit/trypost#430. Replaces #25, which described the pre-2.0 version and was closed with it.

What changes

  • Self-hosting → Configuration → Media sources: a new WebDAV (Nextcloud, ownCloud) subsection after Canva, with the six variables (WEBDAV_ENABLED, WEBDAV_URL, WEBDAV_USERNAME, WEBDAV_PASSWORD, WEBDAV_ROOT, WEBDAV_LABEL) and the per-user listing limit WEBDAV_REQUESTS_PER_MINUTE, what picking a file does, where the credentials go, the read-only app-password advice, the instance-wide-credentials caveat and the private-network rule. The section intro now names the share as one of the sources.
  • Knowledge Base → Media: the share is listed in More media sources.
  • Knowledge Base → Webhooks: webdav added to the media source values.

Sources (trypostit/trypost#430 head)

Claim Code
Variables and defaults config/trypost.php:263-271
Shown only when enabled and URL, user and password are set app/Enums/Media/Source.php:44
Label falls back to WebDAV app/Enums/Media/Source.php:72
Only images and videos are listed; dot-names are hidden app/Services/Media/Sources/WebdavFiles.php (parse, mimeType)
Nothing above the root: empty, . and .. segments are rejected app/Services/Media/Sources/WebdavFiles.php:103
Credentials go to the share's host only, also on redirects app/Enums/Media/Source.php:82, app/Services/Media/RemoteMediaImporter.php (hostAllowed on every redirect)
One import per picked file, copied into the workspace resources/js/components/posts/composer/MediaSourceMenu.vue:189-196
Listing works on a private host, import needs TRYPOST_ALLOW_PRIVATE_NETWORK listing uses Http directly, the import goes through SafeHttpFetcher
source = webdav on the media app/Services/Media/RemoteMediaImporter.php:203

mint broken-links passes.

🤖 Generated with Claude Code

Covers WEBDAV_ENABLED/URL/USERNAME/PASSWORD/ROOT/LABEL and the per-user listing
limit, what picking a file does, where the credentials go, the read-only
app-password advice, the instance-wide credentials caveat and the private
network rule for imports. Lists the source in the media guide and adds
`webdav` to the webhook media `source` values.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
@mintlify

mintlify Bot commented Nov 20, 2026

Copy link
Copy Markdown

Preview approval required

This pull request comes from a fork, so Mintlify won't build a preview until someone with write access approves commit f624047.

Approve preview

This branch has not been deployed

No deployments
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant