Wiki Nextcloud Push

Category wikis · Version 5.5

Upload a federated-wiki page file directly to the remote Nextcloud server via WebDAV when the desktop sync client fails or deletes newly written files. Activates when a public wiki page is written locally but never reaches the live site (broken links / stuck sync). Kept by the Librarian 🗃️ in the Tower's Wikis.

nextcloud-push is a shell script at ~/bin/nextcloud-push that uploads a single file from the local Nextcloud folder directly to the remote Nextcloud server via WebDAV. It was created to solve a recurring problem: the Nextcloud desktop sync client occasionally fails to upload new wiki page files written by Claude Code, leaving links broken on the live site.

The Problem It Solves

When Claude Code writes a new page file to ~/Nextcloud/fedwiki/{domain}/pages/, the Nextcloud desktop client should detect the new file and upload it automatically. This works most of the time. But the sync client has a bug: it occasionally reports An unexpected error occurred even when the server returns HTTP 201 (success), and marks the file as stuck in an error backoff state.

Worse, for newly created wikis whose pages/ folder has never been synced before, the client may delete newly written files entirely — treating them as "deleted on the remote" rather than "new uploads".

The result: pages written by Claude appear locally but never reach the server, so links on the live site return 404.

How It Works

The script bypasses the desktop client entirely and uploads the file directly using a WebDAV PUT request via curl. Before uploading, it walks the remote directory path and issues MKCOL requests to create any missing parent directories — necessary for new wikis whose folder structure doesn't yet exist on the server.

Authentication uses a Nextcloud App Password (not the login password), stored in the NC_PASSWORD environment variable.

# Push a single page file to the remote server:
nextcloud-push ~/Nextcloud/fedwiki/skill.fedwiki.club/pages/journal-skill

# Push all pages in a wiki at once:
for page in ~/Nextcloud/fedwiki/skill.fedwiki.club/pages/*; do
  nextcloud-push "$page"
done

Setup

The script lives at ~/bin/nextcloud-push and is already executable. Two environment variables control it:

NC_USER — Nextcloud username
NC_PASSWORD — a Nextcloud App Password generated in the Nextcloud security settings

Add both to your shell profile so they are available in every terminal session and to Claude Code:

export NC_USER="your-username"
export NC_PASSWORD="your-app-password-here"

HTTP 201 means a new file was created. HTTP 204 means an existing file was updated. Both are success.

Why Browsing the Web UI Also Fixes It

Browsing to the Nextcloud web UI and navigating into a folder causes the server to emit a push notification via the Nextcloud Notify Push service. The desktop sync client is subscribed to these notifications and wakes from its backoff state when it receives one — which is why navigating to the folder in a browser sometimes triggers an otherwise-stuck sync. nextcloud-push is simply a faster, more reliable version of that same effect.

Related Skills

agentprivacy-wiki-page — how pages are written to the Nextcloud folder
agentprivacy-wiki-reindex — rebuild indexes after pages land
agentprivacy-wiki-merge — uses this WebDAV push during bulk moves

Verify: agentprivacy.ai · kept by the Librarian 🗃️ in the Tower's Wikis (the git-less onboarding layer)
Upstream: skill.fedwiki.club/nextcloud-push — vendored + re-framed; not original agentprivacy authorship

Provenance

Forkable skill page migrated from the agentprivacy skills repo (persona/agentprivacy-wiki-nextcloud-push, v5.5).
Source of truth: agentprivacy-skills-v5. Fork this page to materialize a local SKILL.md via fedwiki-to-skill.

origin: 0xagentprivacy · author: Mitchell Travers

Assets

📎 wiki-nextcloud-pushSKILL.md

Navigation

← Welcome Visitors · The Wikis