Troubleshooting
By topic
| Page | For example |
|---|---|
| Installation and startup | A container keeps restarting, the health check stays starting, lost secret.key |
| Uploads | 413 from the proxy, Storage limit reached, Invalid upload chunk |
| Login and security | Too many attempts, everyone has the same IP, Invalid origin, passkeys |
| Single sign-on | Wrong address, discovery fails, Google invalid_client, no linked account |
| Live updates | Lists only change after a reload |
| Couldn't send the test email | |
| AI | Model downloads, out of memory, a stuck queue |
| Storage | Could not connect, Could not list the storage |
| Webhooks | Private addresses, timeouts, webhooks that turned off |
| Updates | Couldn't update Fileship, the updater can't be reached |
| Windows app and extension | Server too old, invalid upload token, missing permissions |
Before anything else, read the server output: docker compose logs --tail=200 fileship-blue fileship-green with Docker, journalctl -u fileship without.
Error messages
Every message the dashboard and the API show, in English, and where to read about it. … stands for a value filled in, such as a name, a number or an error from another system. Messages also appear in the language set for the account; the API answers in the language of the Accept-Language header.
| Message | Read |
|---|---|
| A backup is being restored, try again when it finishes | Backups |
| A backup restoration is already in progress | Backups |
| A Discord layout is empty or too large for Discord | Link previews |
| A file with that name already exists | Uploads |
| A file with that name is in the trash | Uploads |
| A folder can't be moved into itself or a folder inside it | Folders |
| A migration is already running | Storage |
| A password is required | Inbox |
| A user with that username already exists | Users and permissions |
| AI features are turned off | AI |
| An archive job is already running for this folder | Folders |
| An import is already running | Storage |
| Another account already uses this email address | Email setup |
| Archive not found | Folders |
| Avatar must be at least 64x64 pixels | Instance settings |
| Avatar must be less than … MB | Instance settings |
| Backup limit must be a whole number | Backups |
| Backup limit must be at least -1 | Backups |
| Backup limit reached | Backups |
| Backup not found | Backups |
| Backups must be .tgz files | Backups |
| Choose at least one event | Webhooks |
| Chunk offset must be at least 0 | Uploads |
| Color must be 7 characters | Link previews |
| Color must start with # | Link previews |
| Compression must be at least 0 | Files |
| Compression must be at most 100 | Files |
| Content must be at least 1 character | Notes |
| Content must be at most 50000 characters | Notes |
| Could not connect: … | Storage |
| Could not list the storage: … | Storage |
| Could not read the image | Windows app and extension |
| Couldn't log in with …. Try again. | Single sign-on |
| Couldn't read the discovery document: … | Single sign-on |
| Couldn't send the email. Try again later. | |
| Couldn't send the test email: … | |
| Current chunk must be at least 1 | Uploads |
| Domains must be at most 253 characters | Custom domains |
| Email isn't set up on this instance | |
| Enter a name | Webhooks |
| Enter a username | Folders |
| Enter a valid http or https URL | Short links |
| Enter your two-factor authentication code | Login and security |
| Expiration must be at least 0 | Short links |
| Failed to process avatar | Instance settings |
| File name cannot start with a dot | Uploads |
| File name must be at least 3 characters | Uploads |
| File name must be at most 255 characters | Uploads |
| File not found | Files |
| Finish logging in with single sign-on first | Single sign-on |
| Folder not found | Folders |
| Folders can be nested up to … levels deep | Folders |
| Inbox not found | Inbox |
| Inbox password must be at most 48 characters | Inbox |
| Invalid authentication response | Login and security |
| Invalid avatar | Instance settings |
| Invalid avatar image | Instance settings |
| Invalid backup file | Backups |
| Invalid file | Uploads |
| Invalid files | Folders |
| Invalid origin | Login and security |
| Invalid passkey | Login and security |
| Invalid password | Login and security |
| Invalid query | Files |
| Invalid two-factor authentication code | Login and security |
| Invalid upload chunk | Uploads |
| Invalid upload id | Uploads |
| Invalid username or password | Login and security |
| Invalid verification method | Login and security |
| Invite not found | |
| Job is not done yet | Folders |
| Job not found | Folders |
| Link not found | Short links |
| Max clicks must be at least 0 | Short links |
| Max views must be at least 0 | Files |
| Missing backup file | Backups |
| Missing file | Uploads |
| Missing image | Windows app and extension |
| Name can be at most 64 characters | Webhooks |
| Name is required | Uploads |
| Name must be at least 1 character | Folders |
| Name must be at least 3 characters | Users and permissions |
| Name must be at most 255 characters | Uploads |
| Name must be at most 32 characters | Users and permissions |
| No account is linked to this … account. Ask an admin, or log in another way and link it in Settings → Security. | Single sign-on |
| No files found to delete | Files |
| No files to archive in this folder | Folders |
| No single sign-on account is linked | Single sign-on |
| No user has that username | Folders |
| Note not found | Notes |
| Nothing to update | Updates |
| Open Fileship at its dashboard address to use single sign-on. | Single sign-on |
| Open Fileship at … to link single sign-on | Single sign-on |
| Passkey not found | Login and security |
| Password login is turned off, log in with single sign-on | Single sign-on |
| Password login is turned off, so you couldn't log in without single sign-on | Single sign-on |
| Password must be at least 8 characters | Users and permissions |
| Password must be at most 48 characters | Users and permissions |
| Permissions must be provided if user is not a super admin | Users and permissions |
| Registration is disabled | Registration |
| Secret can be at most 256 characters | Webhooks |
| Session not found | Login and security |
| Set a password or add a passkey first, so you can still log in | Single sign-on |
| Single sign-on isn't available right now | Single sign-on |
| Single sign-on isn't available right now. Try again later or ask an admin. | Single sign-on |
| Slug already taken | Inbox |
| Slug can only contain letters, numbers, dashes and underscores | Inbox |
| Slug cannot be empty | Inbox |
| Slug must be at most 48 characters | Inbox |
| Some fields are invalid | Upload API |
| Storage is in use | Storage |
| Storage limit reached | Uploads |
| Storage not found | Storage setup |
| That short link is already taken | Short links |
| The account with this email address is already linked to a different … account. | Single sign-on |
| The authenticator app is already disabled | Login and security |
| The authenticator app is already enabled | Login and security |
| The chosen file is gone, choose it again | Moving from another app |
| The code must be 6 digits | Login and security |
| The code must contain only digits | Login and security |
| The image is too large | Windows app and extension |
| The inbox folder and the folders that contain it can't be deleted | Folders |
| The login took too long or was started in another window. Try again. | Single sign-on |
| The login with … was cancelled. | Single sign-on |
| The request expired, try again | Login and security |
| The request is too large | Uploads |
| The request must include its length | Uploads |
| The request was interrupted | Uploads |
| The security check failed, try again | Login and security |
| This file name is reserved | Uploads |
| This invitation is invalid or has expired | |
| This isn't a Zipline export or an XBackBone or Chibisafe database | Moving from another app |
| This link is invalid or has expired | |
| This passkey isn't registered here | Login and security |
| This person has no access to this folder | Folders |
| This slug is reserved | Inbox |
| This URL points to a private or local address. A super admin can allow these in the instance settings. | Webhooks |
| This username is already taken | Users and permissions |
| This … account is already linked to another account. | Single sign-on |
| Thumbnail not found | Files |
| Title must be at least 3 characters | Notes |
| Title must be at most 48 characters | Notes |
| Too many attempts, try again later | Login and security |
| Too many chunks | Uploads |
| Total chunks must be at least 1 | Uploads |
| Two-factor authentication is enabled, enter the code from your authenticator app | Login and security |
| Two-factor authentication is not enabled for this account | Login and security |
| Upload already completed | Uploads |
| Upload not found | Uploads |
| URL can be at most 2048 characters | Webhooks |
| URL must be at most 2048 characters | Short links |
| Usable space must be a whole number | Users and permissions |
| Usable space must be at least -1 | Users and permissions |
| Use a secret of at least 16 characters | Webhooks |
| Use the … account that is linked to your account. | Single sign-on |
| Use up to 32 letters, numbers, dashes or underscores | Short links |
| User not found | Users and permissions |
| Username already taken | Users and permissions |
| Username must be at least 3 characters | Users and permissions |
| Username must be at most 24 characters | Users and permissions |
| Verification is required | Login and security |
| Wait for the import to finish | Storage |
| Wait for the storage migration to finish | Storage |
| Webhook not found | Webhooks |
| You are already logged in | Login and security |
| You are not signed in as another user | Users and permissions |
| You can add at most 50 domains | Custom domains |
| You can add up to … webhooks | Webhooks |
| You can keep up to … backups | Backups |
| You can't share a folder with yourself | Folders |
| You cannot delete a super admin | Users and permissions |
| You cannot delete yourself | Users and permissions |
| You cannot grant super admin rights | Users and permissions |
| You cannot remove super admin from yourself if you are the only super admin | Users and permissions |
| You cannot sign in as this user | Users and permissions |
| You cannot update a super admin | Users and permissions |
| You do not have permission to access this page | Notes |
| You do not have permission to create a super admin | Users and permissions |
| You do not have permission to perform this action | Upload API |
| You must be logged in to perform this action | Upload API |
| … is not a valid domain | Custom domains |
Messages about a field's length or format (Must be at least … characters, Enter a valid URL, Choose at least …) come from the form you filled in and say what to change.