Repository navigation
Implement resumable uploads for Nextcloud #47682
Description
TL;DR: We will implement https://datatracker.ietf.org/doc/draft-ietf-httpbis-resumable-upload/
Motivation
Chunked upload is useful in many cases, but also slower than uploading the entire file directly.
Overall it is slower because multiple network requests have to be made.
The speed of requests varies during their lifetime, as it is slower at the beginning and then flattens out at the maximum over time.
The smaller the requests are and the more we make, the worse performance penalty.
Thus to increase chunked upload speed the size of chunks should be increased.
A single upload using cURL is the upper limit of the possible upload speed for any configuration and upload method.
A chunked upload with the chunk size equal to or greater than the file size represents the upper limit for chunked uploads as it only uploads a single chunk.
While reaching the former would be nice, only the latter is achievable (without general performance improvements in WebDAV regardless of the maximum chunk size) and thus represents the theoretical goal.
Testing methodology
Input
dd if=/dev/random of=1G.bin bs=1G count=1
Scenarios
All tests are running on a local instance using the PHP standalone web server with 10 workers and no extra apps enabled.
The machine has a Ryzen 5 5800X (8 threads, 16 cores), 48GB RAM and a NVMe M.2 Samsung 980 SSD 1TB.
Hardware should not be a bottleneck on this setup and external networking can not have an effect either.
1. cURL single upload
Take the Real timing value.
time curl -X PUT "http://localhost:8080/remote.php/webdav/1G.bin" -u admin:admin --upload-file 1G.bin
Runs:
5.412s
5.223s
5.100s
Average: 5.245s
Note: I once saw an outlier that only took about 4.7s, but this never happened again.
Chunked upload via browser
Open Firefox Devtools and filter network requests by dav/uploads.
Upload 1G.bin via web interface.
Take Started of first (MKCOL) and the Downloaded of the last (MOVE) request and subtract them (See the Timings tab of each request).
This includes some constant overhead for the MKCOL and MOVE requests which is not relevant for comparing chunked upload timing results as they all have the same overhead, but when comparing to the cURL scenario it accurately measures the overall time for the upload process.
According to https://firefox-source-docs.mozilla.org/devtools-user/network_monitor/throttling/index.html "Wi-Fi" throttling means a maximum speed of 15 Mbps.
Sadly this is the "fastest" speed one can select for throttling and there is no way to set a custom speed.
It should represent a worst-case, while most uploads are probably done with 2-3x that speed in the real world if the Nextcloud instance is not on the same network.
Adjusting the default maximum chunk size can be done in
Line 45 in 7964058
| $maxChunkSize = (int)Server::get(IConfig::class)->getAppValue('files', 'max_chunk_size', (string)(10 * 1024 * 1024)); |
2. Chunk size 10MiB (current default), unlimited bandwidth
Chunks: 103
Runs:
47.16s
47.65s
47.33s
Average: 47.38s
3. Chunk size 100MiB, unlimited bandwidth
Chunks: 11
Runs:
8.53s
8.64s
8.63s
Average: 8.6s
4. Chunk size 1024MiB, unlimited bandwidth
Chunks: 1
Runs:
6.37s
6.34s
6.34s
Average: 6.35s
5. Chunk size 10MiB (current default), throttled "Wi-Fi"
Chunks: 103
Runs:
551.40s
551.40s
551.40s
Average: 551.40s
6. Chunk size 100MiB, throttled "Wi-Fi"
Chunks: 11
Runs:
552.60s
549.60s
551.40s
Average: 551.2s
7. Chunk size 1024MiB, throttled "Wi-Fi"
Chunks: 1
Runs:
568.20s
555.60s
553.11s
Average: 558.97s
Conclusions
-
Upload speed in Nextcloud is very consistent regardless of upload method. Great!
-
Chunked upload in general takes about 21% longer in scenarios with unlimited bandwidth (scenario 1 and 4). Whether this overhead can be eliminated easily is not clear, but at least there is no hard limitation since both uploads are done through WebDAV and thus use the same underlying stack (also see other interesting findings section below).
-
In the current default configuration with unlimited bandwidth chunked upload is takes 646% longer than the maximum speed (scenario 2 and 4). By increasing the chunk size by 10x keeping the bandwidth ulimited it only takes 35% longer than the maximum speed (scenario 3 and 4). This is a 5.5x increase in total throughput (scenario 2 and 3).
-
In bandwidth limited scenarios increasing the chunk size has almost no positive (and no negative effect; scenario 5 and 6). This is expected as the slow speed at the beginning of each chunk is a lot smaller on relation to the overall speed or even exactly the same.
-
Increasing the chunk size helps uploads on fast connections while it has no downsides on slow connections speed wise. Slow networks can be correlated with unstable networks, so having fewer and larger chunks could result in a higher rate of aborted chunk uploads. This downside should be taken into consideration when choosing a new maximum chunk size.
-
A new maximum chunk size still needs to be figured out by collecting more data for different chunk sizes. It needs to hit a sweet spot of maximum speed with minimum size to account for the before mentioned drawback on unstable networks (basically the point of diminishing returns). This investigation was only to prove that we can increase the chunked upload speed.
Other interesting findings
While uploading with a single chunk and unlimited bandwidth Firefox displayed that the request needed 637ms to send but had to wait 2.10s after that (reproducible). This might show that we have a bottleneck in processing the uploads on the backend side. Maybe it would be possible to stream the request data directly into the file while should cut down the waiting time a lot. It should be possible to profile these requests and figure out where the time is spent.
For single chunks the MOVE request still takes quite some time. I assume this happens because it concatenates the chunks while there is only one (which is slow because it has to read and write all the data). This case could be detected and the file moved without reading and writing it (which is not possible for all storages AFAICT, i.e. it needs to be on the same physical disk to take advantage of it). This only affects uploads where the file size is less than the maximum chunk size. Due to the current low limit it is not really noticable, but with a higher maximum chunk size this would affect a lot more and bigger uploads and could lead to quite a performance improvement for those.
Upload ETA calculations are all over the place due to the varying speed of uploading chunks over their lifetime. It could be improved by taking the overall time a chunk needs to upload and multiplying it by number of remaining chunks. This should be a lot more reliable as every chunk should have a similar upload characteristics. To smooth out the the value it could take into account the last 3-5 chunks.
Metadata
Metadata
Assignees
Labels
Type
Projects
- StatusShow more project fields📄 To do (max 2 entries / member)
- StatusShow more project fieldsTriaged
Activity
joshtrichards commentedon Sep 2, 2024
Good stuff.
A couple thoughts:
The Desktop client has already traveled the bumps from 10MB -> 1000MB -> 5000MB so there are some data points there. The main problem with the desktop client's approach at the moment is that we don't have back-off logic in place when the higher chunk size doesn't work. This creates problems when it runs up against web/proxy limits (default or otherwise)1. But that is fixable (I think).
To avoid unnecessary support issues, invalid bug reports, and a poor user experience: Increasing the default chunk size should probably account for widespread limitations2 (or) have a good dynamic/back-off logic to reconfigure if the end-to-end path doesn't seem to be working with the larger chunk size (or) be really well documented. Preferably either/both of the former two. :-)
We have variance in behavior among our various clients. Ideally we unify defaults and behavior. Unless there's a compelling reason not too of course.
A shared ability to set the chunk size either globally or on a per client type basis might be nice. Currently the server-side parameter is only applicable to the Web client. And the chunk size isn't even configurable in our Android client (for example).
Footnotes
e.g. See "Connection closed" message when syncing files larger then +- 100Mb desktop#4278 ↩
Reasons this happens: Apache
LimitRequestBodydefaults to 1GB these days (used to be unlimited by default), CloudFlare freebie level (100MB) which leads to lots of false bug reports/poor user experiences, and various other web/proxy body/transaction size limits. ↩provokateurin commentedon Sep 2, 2024
@joshtrichards thanks for your input! Highly appreciated having pointers to related topics :)
provokateurin commentedon Sep 2, 2024
Hi, @nextcloud/desktop would it be possible to sit down with some of you at the Conference in two weeks and discuss this? I think we can figure out something together, solve the problems and unify the behavior across clients and the web.
provokateurin commentedon Sep 2, 2024
Also @joshtrichards (and anyone else) feel free to join in case this takes place. You seem to know quite a lot of paint points of this problem which would be really helpful to consider.
camilasan commentedon Sep 2, 2024
@provokateurin Matthieu and me will be at the conference, could you put something on the calendar for this?
will you join us @joshtrichards? :)
provokateurin commentedon Sep 2, 2024
I'll try to find a time slot (the calendar is really full huh) and get it added to the official agenda so everyone interested can join. To avoid collisions with any other event it probably has to be late afternoon.
provokateurin commentedon Sep 3, 2024
Ok, the meeting will take place Wednesday 18.9. 16:00 at Motion Lab. The room is still to be determined, but will be available in the public agenda and calendar on time.
joshtrichards commentedon Sep 3, 2024
I wish I could join, but I'll not in be town for the conference.
provokateurin commentedon Sep 7, 2024
I just realized I might have made a mistake. Instead of the 10 workers I think only 4 were available. Given that the chunked upload tries to upload 5 concurrent chunks at least one of the might have been stalled the whole time.
I will make new measurements to confirm if this is the case and affected the results. Overall it shouldn't changed the picture though, as only up-to 20% of the performance was lost due to this error which is a lot less than the noticed overall performance loss utilizing multiple concurrent chunks.
43 remaining items
[-]Chunked upload performance improvements[/-][+]Implement resumable uploads for Nextcloud [/+]tobiasKaminsky commentedon Sep 30, 2026
@provokateurin since we also want to have this in clients:
provokateurin commentedon Sep 30, 2026
The server PR is just a POC and will need some work to get it updated to the latest draft version. Besides that it doesn't handle the actual storage parts very well at the moment, because I just focussed on implementing the RFC itself and not yet on optimizing it for us.
So @GhassenKefi and me will be working on this for 36, but there is nothing for clients to test yet.
marinofaggiana commentedon Oct 22, 2026
@provokateurin has development begun, or is there still poc?
provokateurin commentedon Oct 27, 2026
I didn't post any update here. So no, development hasn't started yet.
provokateurin commentedon Oct 28, 2026
@GhassenKefi to implement this, the following things need to be done:
.partfile and do a rename at the end)