❓ [Question]: Intermittent upload timeout error during backup process

[HolgerM1]

Contact details ☎️

No response
Any idea about timeout issue on backup🤔

Hi,
I have a Problem with timeout issues. The Problem is not constant. Saturday and Sunday the backup finished without Problems. Today I had (again) the following failure:

Logger: custom_components.pcloud_backup.api
Quelle: custom_components/pcloud_backup/api.py:656
Integration: pCloud Backup (Dokumentation, Probleme)
Erstmals aufgetreten: 06:22:23 (1 Vorkommnis)
Zuletzt protokolliert: 06:22:23

Upload timeout for Automatic_backup_2026.2.3_2026-03-02_04.53_36004187.tar:

Logger: custom_components.pcloud_backup.api
Quelle: custom_components/pcloud_backup/api.py:660
Integration: pCloud Backup (Dokumentation, Probleme)
Erstmals aufgetreten: 06:22:23 (1 Vorkommnis)
Zuletzt protokolliert: 06:22:23

FIFO upload failed for Automatic_backup_2026.2.3_2026-03-02_04.53_36004187.tar. Diagnostics: fifo_path=/tmp/>tmp2eu_c77y.tar.fifo, bytes_written=44206559232, chunk_count=168640, write_error=None, error=Upload timeout >for Automatic_backup_2026.2.3_2026-03-02_04.53_36004187.tar
Traceback (most recent call last):
File "/usr/local/lib/python3.13/site-packages/aiohttp/client_reqrep.py", line 539, in start
message, payload = await protocol.read() # type: ignore[union-attr]
^^^^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.13/site-packages/aiohttp/streams.py", line 703, in read
await self._waiter
asyncio.exceptions.CancelledError

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
File "/config/custom_components/pcloud_backup/api.py", line 632, in _async_upload_via_fifo
async with session.post(
~~~~~~~~~~~~^
url, params=params, data=writer, headers=headers, timeout=UPLOAD_TIMEOUT
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
) as response:
^
File "/usr/local/lib/python3.13/site-packages/aiohttp/client.py", line 1510, in aenter
self._resp: _RetType = await self._coro
^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.13/site-packages/aiohttp/client.py", line 779, in _request
resp = await handler(req)
^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.13/site-packages/aiohttp/client_middlewares.py", line 36, in single_middleware_handler
return await middleware(req, handler)
^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^
File "/usr/src/homeassistant/homeassistant/helpers/aiohttp_client.py", line 72, in _ssrf_redirect_middleware
resp = await handler(request)
^^^^^^^^^^^^^^^^^^^^^^
File "/usr/local/lib/python3.13/site-packages/aiohttp/client.py", line 757, in _connect_and_send_request
await resp.start(conn)
File "/usr/local/lib/python3.13/site-packages/aiohttp/client_reqrep.py", line 534, in start
with self._timer:
^^^^^^^^^^^
File "/usr/local/lib/python3.13/site-packages/aiohttp/helpers.py", line 713, in exit
raise asyncio.TimeoutError from exc_val
TimeoutError

The above exception was the direct cause of the following exception:

Traceback (most recent call last):
File "/config/custom_components/pcloud_backup/api.py", line 660, in _async_upload_via_fifo
raise PCloudAPIError(f"Upload timeout for {filename}") from err
custom_components.pcloud_backup.api.PCloudAPIError: Upload timeout for >Automatic_backup_2026.2.3_2026-03-02_04.53_36004187.tar

Any ideas on that?
I appreciate any help!
Thanks!

Context 🧩

I set up a standard backup scheme with retaining 3 backups on a local share (NAS via SMB), and three at Pcloud. Installation of Pcloud worked flawless, and connection to Pcloud seems to work.

What have you tried? 🛠️

Reboot Homeassistant.

[ghotso]

Thanks for your report! 🙌
I’ve automatically improved the issue title to better reflect the problem you described.
A team member will take a closer look as soon as possible.

[ghotso]

Thanks again for the detailed report!

The timeout for uploads was previously set to 1 hour for the entire upload request. For very large backups (like the ~42 GB tarball in your logs), this can easily be hit on slower or bursty connections.

I’ve already increased the upload (and download) timeout to 24 hours, so large backups have a fair chance to complete successfully.

Unfortunately the temporary-file upload path is not very reliable with the pCloud API in this scenario, so adjusting the timeout was the most practical solution for now.

I’m currently testing the change locally with Home Assistant before tagging a new release. If everything looks good, I should be able to publish an update within the next few days.

[HolgerM1]

Hi ghotso,
Thank you for your response. And thank you very much for providing the tool! For almost a week now, I did not have any issues on backup. Maybe I was a temporary issue. Anyways, thanks!

[HolgerM1]

After two days in row with successful backup, today the next timeout problem with missed cloud backup.