[META] Experimental network features

Experimental network features

Features

There are some network features that have been added to the Immich mobile app through the years that interact with various libraries and background tasks in unexpected ways. These features include:

• HTTP Basic Auth for server URL
• Self-signed SSL certs
• Manually imported root CA / SSL certificate
• Mutual TLS
• Custom HTTP proxy headers

Limitations

Typically, these network features work fine in the normal library view, but cause issues with:

• video playback
• foreground asset upload
• background asset upload
• interrupted uploads
• asset download
• App crashing

Solutions

Thanks to the recent implementation of auto-switching server URLs in #14437, many of these features are no longer needed for a smooth Immich experience. There are other options, including the use of a VPN or a real SSL cert.

Handling known issues

We have updated the FAQ (link will work once #15228 is merged). This issue can be used to track any known issues with these experimental network features. These issues will not be a priority for the dev team, but can be improved by the community if possible.

Please do not use this discussion for comments like "same" or +1". This is designed only to keep track of current known limitations to these experimental features, or discuss potential solutions and future patches.