PHPackages pulli/nextcloud-webdav-uploader - PHPackages - PHPackages [Skip to content](#main-content)[PHPackages](/)[Directory](/)[Categories](/categories)[Trending](/trending)[Leaderboard](/leaderboard)[Changelog](/changelog)[Analyze](/analyze)[Collections](/collections)[Log in](/login)[Sign up](/register) 1. [Directory](/) 2. / 3. [File & Storage](/categories/file-storage) 4. / 5. pulli/nextcloud-webdav-uploader ActiveLibrary[File & Storage](/categories/file-storage) pulli/nextcloud-webdav-uploader =============================== Upload files to Nextcloud over WebDAV from the command line, with chunked uploads, checksum verification, and skip-if-unchanged support. v1.0.1(today)075↑2620%MITPHPPHP ^8.3CI passing Since Jul 23Pushed todayCompare [ Source](https://github.com/the-pulli/nextcloud-webdav-uploader)[ Packagist](https://packagist.org/packages/pulli/nextcloud-webdav-uploader)[ Docs](https://github.com/the-pulli/nextcloud-webdav-uploader)[ GitHub Sponsors](https://github.com/the-pulli)[ RSS](/packages/pulli-nextcloud-webdav-uploader/feed)WikiDiscussions main Synced today READMEChangelog (2)Dependencies (6)Versions (3)Used By (0) Nextcloud WebDAV Uploader ========================= [](#nextcloud-webdav-uploader) [![Latest Version on Packagist](https://camo.githubusercontent.com/ca62526f0226c507ec9fd8ffd2ca253263312c826faf57627e4992e439db4b5b/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f762f70756c6c692f6e657874636c6f75642d7765626461762d75706c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pulli/nextcloud-webdav-uploader)[![Tests](https://github.com/the-pulli/nextcloud-webdav-uploader/actions/workflows/run-tests.yml/badge.svg)](https://github.com/the-pulli/nextcloud-webdav-uploader/actions/workflows/run-tests.yml)[![Total Downloads](https://camo.githubusercontent.com/e6dca95f406ab566f850f3e1a0c6015e5e140c70118bbabe4f1612764f7976c2/68747470733a2f2f696d672e736869656c64732e696f2f7061636b61676973742f64742f70756c6c692f6e657874636c6f75642d7765626461762d75706c6f616465722e7376673f7374796c653d666c61742d737175617265)](https://packagist.org/packages/pulli/nextcloud-webdav-uploader) A standalone command-line tool for uploading files and folders to Nextcloud over WebDAV. Files above ~4 GiB automatically use Nextcloud's NG chunking API instead of a single PUT. Every upload is checksummed: unchanged files are skipped on a rerun, and every fresh upload is verified against the remote checksum afterwards. > Using Laravel? See [laravel-nextcloud-webdav-uploader](https://github.com/pulli-org/laravel-nextcloud-webdav-uploader) for an Artisan command built on top of this package's `NextcloudClient`. Features -------- [](#features) - Upload single files or whole directories (optionally recursive) - Automatic chunked uploads for large files, with a progress bar - SHA1 checksum skip-if-unchanged: rerunning against the same destination only transfers what changed - Post-upload checksum verification, so a corrupted transfer fails loudly instead of silently - Optional public share link creation Installation ------------ [](#installation) You can install the package via composer: ``` composer require pulli/nextcloud-webdav-uploader ``` Configuration ------------- [](#configuration) The tool reads its Nextcloud credentials from environment variables, either exported directly or via a `.env` file in the current working directory: ``` NEXTCLOUD_URL=https://cloud.example.com NEXTCLOUD_USERNAME=jane NEXTCLOUD_PASSWORD=app-password # Optional overrides NEXTCLOUD_CHUNK_THRESHOLD=4294967296 # bytes; default ~4 GiB NEXTCLOUD_CHUNK_SIZE=536870912 # bytes; default 512 MiB NEXTCLOUD_TIMEOUT=300 # seconds ``` See [`.env.example`](.env.example). Usage ----- [](#usage) ``` # Upload a single file into /Uploads ./nextcloud-webdav-uploader --file=/path/to/file.pdf # Upload into a specific folder (created if missing) ./nextcloud-webdav-uploader Documents/2026 --file=/path/to/file.pdf # Upload a directory (its direct files only) as a subfolder of the target folder ./nextcloud-webdav-uploader Backups --file=/path/to/folder # ...including nested subdirectories, preserving structure ./nextcloud-webdav-uploader Backups --file=/path/to/folder --include-subdirs # Multiple files/folders in one run ./nextcloud-webdav-uploader Backups --file=/path/a --file=/path/b.txt # Create (or reuse) a public share link for the target folder afterwards ./nextcloud-webdav-uploader Shared --file=/path/to/file.pdf --share-dir # ...or for the uploaded file itself (only valid with exactly one file) ./nextcloud-webdav-uploader Shared --file=/path/to/file.pdf --share-file ``` Rerunning the same command only re-uploads files whose content actually changed — everything else is reported as `unchanged, skipped`. ### Options [](#options) OptionDescription`folder`Target folder in Nextcloud, relative to the user's files root (default: `Uploads`)`--file`, `-f`Local file or directory to upload (repeatable)`--include-subdirs`Recurse into subdirectories of a `--file` directory, preserving structure`--chunk-size`Override the chunk size in MB for files above the chunking threshold`--force-chunk-above`Override the chunking threshold in MB (useful to exercise chunking without a huge test file)`--share-dir`Create (or reuse) a public link share for the target folder and print it`--share-file`Create (or reuse) a public link share for the uploaded file and print it (exactly one file only)Testing ------- [](#testing) ``` composer test ``` Changelog --------- [](#changelog) Please see [CHANGELOG](CHANGELOG.md) for more information on what has changed recently. Credits ------- [](#credits) - [PuLLi](https://github.com/the-pulli) - [All Contributors](../../contributors) License ------- [](#license) The MIT License (MIT). Please see [License File](LICENSE.md) for more information. ### Health Score 45 — FairBetter than 91% of packages Maintenance100 Actively maintained with recent releases Popularity13 Limited adoption so far Community6 Small or concentrated contributor base Maturity49 Maturing project, gaining track record Bus Factor1 Top contributor holds 100% of commits — single point of failure How is this calculated?**Maintenance (25%)** — Last commit recency, latest release date, and issue-to-star ratio. Uses a 2-year decay window. **Popularity (30%)** — Total and monthly downloads, GitHub stars, and forks. Logarithmic scaling prevents top-heavy scores. **Community (15%)** — Contributors, dependents, forks, watchers, and maintainers. Measures real ecosystem engagement. **Maturity (30%)** — Project age, version count, PHP version support, and release stability. ### Release Activity Cadence Every ~0 days Total 2 Last Release 0d ago ### Community Maintainers ![](https://www.gravatar.com/avatar/c14e16040b5b84e5c91af8c7a39480567d951bfc27673f97d9c75480dbe20b5e?d=identicon)[pulli](/maintainers/pulli) --- Top Contributors [![the-pulli](https://avatars.githubusercontent.com/u/112799107?v=4)](https://github.com/the-pulli "the-pulli (5 commits)") --- Tags WebDAVuploadnextcloudpulli ### Code Quality TestsPest Code StyleLaravel Pint ### Embed Badge ![Health badge](/badges/pulli-nextcloud-webdav-uploader/health.svg) ``` [![Health](https://phpackages.com/badges/pulli-nextcloud-webdav-uploader/health.svg)](https://phpackages.com/packages/pulli-nextcloud-webdav-uploader) ``` ### Alternatives [laravel/framework The Laravel Framework. 34.8k543.8M20.5k](/packages/laravel-framework)[drupal/core Drupal is an open source content management platform powering millions of websites and applications. 19566.0M1.8k](/packages/drupal-core)[drupal/core-recommended Locked core dependencies; require this project INSTEAD OF drupal/core. 6942.5M425](/packages/drupal-core-recommended)[aedart/athenaeum Athenaeum is a mono repository; a collection of various PHP packages 255.2k](/packages/aedart-athenaeum)[lion/bundle Lion-framework configuration and initialization package 122.4k4](/packages/lion-bundle)[tempest/framework The PHP framework that gets out of your way. 2.2k34.4k16](/packages/tempest-framework) PHPackages © 2026 [Directory](/)[Categories](/categories)[Trending](/trending)[Changelog](/changelog)[Analyze](/analyze)