---
title: "WebFTP issues"
description: "Resolve WebFTP transfer errors in Alpacon. Check file name and path limits, session expiry, missing transfers, and the messages shown by the alpacon cp command."
---

> Full documentation index: https://docs.alpacax.com/llms.txt

# WebFTP issues

Use the message or symptom below to find why a WebFTP transfer failed and what to do next.

## Limits

| Limit | Value |
| --- | --- |
| File or folder name | Up to 128 characters; up to 124 for a folder on an object-storage deployment. |
| Path | Up to 512 characters. |
| Session duration | 1 day from opening the session. This limit is not adjustable. |
| Transfer lifetime | 1 day from creating the transfer. |
| Monthly transfer volume | Depends on the workspace's plan. See [Plans & billing](/use/workspace/plans-billing/). |

## Error codes

Find the error code below. The CLI may show a shorter message without a code; see [CLI messages](#cli-messages).

The error message reference has the console wording for [webftp_name_too_long](/reference/error-messages/#webftp_name_too_long), [max_length](/reference/error-messages/#max_length), [webftp_invalid_path](/reference/error-messages/#webftp_invalid_path), [webftp_limit_exceeded](/reference/error-messages/#webftp_limit_exceeded), [webftp_content_not_accepted](/reference/error-messages/#webftp_content_not_accepted), and [auth_interactive_channel_requires_presence](/reference/error-messages/#auth_interactive_channel_requires_presence).

## The session closed on its own

A WebFTP session ends 1 day after it opened. Activity and browser reconnects do not reset this time limit, and you cannot extend it in settings. Open WebFTP again to continue transferring files.

A session also ends when the file-transfer service restarts or its work session ends. If the work session has expired, completed, or been revoked, request another work session before opening WebFTP.

## A transfer is missing from the list

A transfer expires 1 day after it is created. After expiry, it does not appear in the transfer list and you cannot open its details. Expired transfers and their stored files are deleted 7 days after expiry. Start the transfer again if you still need the file.

## CLI messages

The [`alpacon cp` command](/reference/cli/cp/) does not include the error code in every refusal. Check the operation and the input alongside its message:

- `Invalid input.`: an overlong file or folder name can produce this message. Shorten the name to the limit above and retry.
- `path: Invalid input.`: a multi-file download that spans different folders produces this message. Download the files from each folder separately.
- `files: Invalid input.`: an older client can produce this message when its upload method is not supported by the deployment. Update the CLI and retry.
- `plan limit reached: WebFTP transfer volume this month.`: the workspace has used its monthly transfer allowance. The message includes reset and upgrade guidance; wait for the reset or review [Plans & billing](/use/workspace/plans-billing/).

## Related docs

- [Upload files](/use/work-sessions/files/upload/)
- [Connection issues](/use/work-sessions/troubleshoot-connections/)
- [Websh sessions](/use/work-sessions/terminal/sessions/)

Source: https://docs.alpacax.com/use/work-sessions/files/troubleshooting/