This server is not a supported Immich v3 server.iPhone
Destination compatibility needs attentionAndroid
- What it means
- Your server isn't running Immich v3.
- What to do
- Update Immich to v3, then connect again.
Help centre
How can we help?
Quick answers about Frameport and Immich, and fixes for the messages the app shows.
Getting startedInstall, connect and run your first backup.About FrameportWhat it is, what it costs and where it runs.Connecting to ImmichServer versions, keys and home networks.BackupsWhat gets uploaded, and when.Privacy and securityWhat Frameport can see, and what it keeps.TroubleshootingWhat each message means, and how to fix it.
About Frameport
What it is, what it costs and where it runs.
Is Frameport free?
Yes. Frameport is free on Google Play. The iPhone version is in App Store review now.
Which phones does it work on?
Android 7.0 or later, from Google Play. The iPhone and iPad app needs iOS or iPadOS 17 or later, and is in App Store review.
Do I need my own Immich server?
Yes. You need an Immich v3 server you run or have permission to use. Immich is the only supported destination for now.
How is this different from the official Immich app?
The official Immich app is a full client: it can view, search, download, edit, share and delete everything in your library. Frameport does one job. It uploads new photos and videos and can't see anything already on your server. Keep using Immich on the web or desktop to enjoy your collection. See the comparison.
Is Frameport part of Immich?
No. Frameport is made by Vexon Group LTD. Immich is an independent open-source project, and Frameport isn't affiliated with or endorsed by it.
Connecting to Immich
Server versions, keys and home networks.
Which version of Immich do I need?
Immich v3. Frameport checks the server's version when you connect and stops with “This server is not a supported Immich v3 server” on anything else.
On Android, signing in with your email and password or single sign-on needs Immich 3.2 or later. On older v3 servers, connect with an API key instead.
What permission does the API key need?
Only asset.upload. Frameport uses it to upload files and to ask your server which files it already has. It doesn't need any read, download or delete permission.
The iPhone app refuses keys with more access than that. On Android, the optional album organisation also needs album.create, albumAsset.create and asset.share.
Is it safe to sign in with my Immich password?
Your email and password, or single sign-on, are used once to create an upload-only key for Frameport, then discarded. Only that narrow key is kept, in the Android Keystore or iOS Keychain.
Can I use a server on my home network without HTTPS?
Yes, but only to a private-network address, and only after you confirm it. Frameport never disables certificate checks for HTTPS.
- Android: use a private address or local hostname and confirm “Use an unencrypted LAN connection?”. You can also save a home network address next to your public HTTPS one.
- iPhone: use a private IP address such as
http://192.168.1.20:2283and turn on “Allow HTTP to a trusted local IP address”. Hostnames must use HTTPS.
My Immich is behind a reverse proxy on a sub-path. Does that work?
On Android, yes: enter the full address including the path, for example https://example.net/immich. The iPhone app needs Immich at the root of its address (an /api suffix is fine).
Backups
What gets uploaded, and when.
Will my photos be compressed?
No. Files are uploaded as originals, with no resizing, recompression or metadata changes. Location data stays in the file.
Will it upload photos my server already has?
No. Before uploading, Frameport sends your server a checksum of each file and skips anything it already has. Those show as already on your server.
When does automatic backup run?
- Android: shortly after new photos or videos appear, with a check every few hours as a safety net. Your cellular, charging, capture-delay, hours and battery settings apply. Backing up yourself is never limited by hours or battery.
- iPhone: iOS decides when background backup runs. It needs Background App Refresh on, and stops if you force-quit Frameport until you open it again. For the fastest progress, keep Frameport open.
Are original file names kept?
Yes, by default. On Android you can switch off “Keep original file names” in Settings, and files are then uploaded under a generated name instead.
Does deleting a photo on my phone delete it from Immich?
No. Frameport never changes or deletes anything on your server. On Android, the optional “Free up space” can remove phone copies your server has already confirmed, through Android's own confirmation and trash.
Privacy and security
What Frameport can see, and what it keeps.
Can Frameport see or delete my existing photos?
No. Frameport can't browse, download, search, edit, share or delete anything in your Immich library. With an upload-only API key, your server would refuse it anyway.
Does Frameport collect any data?
There's no Frameport account, no developer-run cloud storage and no analytics. Your media goes straight from your phone to your server. Read the full privacy policy.
How do I stop Frameport accessing my server?
Delete its key in Immich under Account settings › API keys. Disconnecting the server in Frameport also removes the saved key from your phone.
Troubleshooting
Find the message Frameport is showing you.
The server could not be reached. Check its address and your network.iPhone
Connection could not be verified. Check the server address, access, and network, then try again.Android
- What it means
- Frameport couldn't reach your server from this network.
- What to do
- Open the same address in your phone's browser. If it doesn't load, check the address, your VPN, or whether the server is only reachable at home. For local servers, see servers on your home network.
Secure connection needs attentionAndroid
The secure connection could not be validatedAndroid
- What it means
- Your server's HTTPS certificate is expired, self-signed or doesn't match the address.
- What to do
- Use a valid certificate, for example from Let's Encrypt through your reverse proxy. Frameport won't turn off certificate checks.
Upload key rejectediPhone
Destination sign-in needs attentionAndroid
- What it means
- Your server stopped accepting Frameport's key, usually because it was deleted in Immich.
- What to do
- Tap Reconnect and sign in again, or paste a new upload-only key.
Sign-in options could not be checkedAndroid
- What it means
- Your server is older than Immich 3.2, which Android needs for password and single sign-on.
- What to do
- Continue with an API key instead. Create one in Immich.
This credential belongs to a different account; add a separate destination instead.Android
- What it means
- When reconnecting, the key or sign-in belongs to a different Immich user than before.
- What to do
- Reconnect with the original account, or add the other account as a new destination.
The server or proxy rejected the upload sizeAndroid
- What it means
- A large video was refused, usually by a reverse proxy's upload limit.
- What to do
- Raise the proxy's maximum request size, for example
client_max_body_size 0;in nginx, or the matching setting in your proxy or tunnel.
Your Immich account is fulliPhone
- What it means
- Your Immich user has reached its storage quota.
- What to do
- Free up space in Immich, or ask your server's admin to raise your quota.
Automatic backup isn't runningAndroid
Background App Refresh is off, so Frameport backs up only while open.iPhone
- What it means
- Your phone is stopping Frameport from running in the background.
- What to do
- On Android, follow the steps Frameport shows for your phone, usually letting it run without battery restrictions. On iPhone, turn on Background App Refresh for Frameport and avoid force-quitting it. More detail.
Media access is requiredAndroid
Photos access is offiPhone
- What it means
- Frameport no longer has permission to read your photos.
- What to do
- Open your phone's Settings, find Frameport, and allow access to photos and videos.
Photos are waiting for Wi-FiAndroid
Waiting for Wi‑FiiPhone
- What it means
- Nothing is wrong. Cellular uploads are off, which is the default.
- What to do
- Connect to Wi-Fi, or allow photos or videos on cellular in Frameport's settings.
Not enough space on iPhoneiPhone
- What it means
- Your iPhone doesn't have enough free space for Frameport to prepare an upload.
- What to do
- Free up some space on your iPhone, then Frameport will carry on.
Still need help?
Email us and we'll get back to you. Tell us which phone you use, your Immich version, and what Frameport shows.
[email protected]Attach a diagnostic report
Frameport can prepare one when you ask. Credentials, addresses, file names and locations are removed, and you can read all of it before choosing where to share it. Nothing is sent automatically.