Getting Started

Connect natively to Synology Photos or Immich, or to any system supporting WebDAV (or SMB / CIFS). Choose your NAS below for a step-by-step guide.

Make sure Synology Photos is installed

Synology Photos connections require DSM 7.0 or later. Open Package Center on your NAS, confirm the 'Synology Photos' package is installed, and open the app once so your photo library is set up.

Find your NAS address

Note your NAS web address, including the protocol and port: https://YOUR_NAS_IP:5001 for HTTPS (recommended) or http://YOUR_NAS_IP:5000 for HTTP. You can use an IP address or a domain name. QuickConnect IDs and .local addresses are not supported.

Use your DSM account

Sign in with your normal DSM username and password, the same credentials you use to log in to DSM. No dedicated user or WebDAV server is needed. Accounts with two-factor authentication (2FA) enabled are not currently supported.

Connection Details

Method:Synology Photos

URL:https://YOUR_NAS_IP:5001

Username:your_dsm_user

Password:your_dsm_password

In Pixette, choose 'Synology Photos' as the connection method, then enter these details. Default ports are 5000 (HTTP) and 5001 (HTTPS). All values are case-sensitive.

No WebDAV setup required

Unlike the WebDAV method, Synology Photos connects straight to the Photos app. You don't need to install the WebDAV Server package or create a dedicated user, just sign in with your DSM account.

Folders and albums, personal and shared

Pixette can browse your personal Synology Photos library as well as the shared space (if enabled on your NAS), either by folder or by album.

Using two-factor authentication?

Synology Photos connections don't currently support accounts with 2FA (one-time password) enabled. Use an account without 2FA, or connect via the WebDAV method instead.

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Pixette folder browser showing NAS photo directories

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Find your Immich server URL

Note the full address of your Immich server, including the protocol and port, for example https://immich.example.com:2283 or http://YOUR_SERVER_IP:2283. The default Immich port is 2283. HTTPS is recommended. You can use an IP address or a domain name.

Use your Immich account

Sign in with your Immich email and password, the same credentials you use to log in to the Immich web app. No API key or dedicated user is needed.

Choose your library or albums

Pixette can play your entire Immich library or just specific albums. A data-saver option is available that streams smaller preview images to reduce bandwidth.

Connection Details

Method:Immich

URL:https://immich.example.com:2283

Email:your_immich_email

Password:your_immich_password

In Pixette, choose 'Immich' as the connection method, then enter these details. The default Immich port is 2283. All values are case-sensitive.

No WebDAV setup required

Pixette talks to the Immich API directly. You don't need to enable WebDAV or create a dedicated user, just sign in with your Immich account.

Whole library or by album

Browse and play your entire Immich library, or pick individual albums. Switch the data-saver option on to stream smaller preview images when bandwidth is limited.

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Install WebDAV Server

Open Package Center on your Synology NAS, search for 'WebDAV Server', and install it.

Synology Package Center showing WebDAV Server package

Enable HTTPS

Open the WebDAV Server package, enable HTTPS and set the port to 5006.

WebDAV Server settings with HTTPS enabled on port 5006

Create a dedicated user

Go to Control Panel → User & Group. Create a new user (e.g., 'pixette') with a strong password. In the user creation wizard, go to the Applications tab and allow access to 'WebDAV Server'.

Synology Control Panel user creation wizard

Set folder permissions

Give the new user Read-only access to the shared folders that contain your photos and videos (e.g., the /photo shared folder).

Connection Details

URL:https://YOUR_NAS_IP:5006

Username:pixette

Password:your_password

You can also use your NAS hostname (e.g., https://mynas.local:5006). All values are case-sensitive.

Can't connect?

Check that your device isn't blocked in Control Panel → Security → Account → Auto Block. If the Synology firewall is enabled (Control Panel → Security → Firewall), make sure port 5006 is allowed. Also verify the WebDAV Server logs for detailed error messages.

Connection timeout?

Ensure your device is on the same local network as your NAS. Try using the IP address instead of the hostname.

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Enable WebDAV

Log in to your QNAP NAS admin panel. Go to Control Panel → Network & File Services → Win/MAC/NFS/WebDAV → WebDAV. Enable WebDAV, select 'Shared folder permission', and set a dedicated HTTPS port (e.g. 5006) to avoid conflicts with the QTS web interface.

Configure shared folder permissions

Navigate to Control Panel → Privilege → Shared Folders. Set 'Shared folder permission' to allow WebDAV access to your Multimedia folder.

Create a dedicated user

Go to Control Panel → Privilege → Users. Create a new user (e.g., 'pixette') with a simple password. Avoid special characters for initial testing.

Set user permissions

Grant the new user read-only access to the Multimedia share (or whichever folder contains your photos).

Connection Details

URL:https://YOUR_NAS_IP:5006

Username:pixette

Password:your_password

Replace 5006 with whatever dedicated HTTPS port you configured. All values are case-sensitive.

Tip

Use a simple password (letters and numbers only) for your Pixette user. Some special characters can cause connection issues with WebDAV.

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Get your WebDAV URL

Nextcloud has built-in WebDAV support. Your WebDAV URL follows this format: https://your-nextcloud.com/remote.php/dav/files/USERNAME/

Prepare your credentials

Create an App Password in Settings → Security → Devices & sessions. This is recommended for all setups and required if you have 2FA enabled. Use your Nextcloud username and the generated app password.

WebDAV URL Format

URL:https://your-nextcloud.com/remote.php/dav/files/USERNAME/

Replace your-nextcloud.com with your server address and USERNAME with your Nextcloud username (case-sensitive). If Nextcloud is installed in a subdirectory, include it in the URL (e.g., https://example.com/nextcloud/remote.php/dav/files/USERNAME/).

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Get your WebDAV URL

ownCloud has built-in WebDAV support. Your WebDAV URL follows this format: https://your-owncloud.com/remote.php/dav/files/USERNAME/

Prepare your credentials

Use your ownCloud username and password. If you have two-factor authentication enabled, create an App Password in Settings → Security → App passwords.

WebDAV URL Format

URL:https://your-owncloud.com/remote.php/dav/files/USERNAME/

Replace your-owncloud.com with your server address and USERNAME with your ownCloud username (case-sensitive). The setup is nearly identical to Nextcloud, which was originally forked from ownCloud.

Tip

If you're using ownCloud Infinite Scale (oCIS), the preferred WebDAV endpoint uses the dav/spaces/ path. However, the legacy remote.php/dav/files/USERNAME/ path should still work. You can find your WebDAV URL in your personal settings in the oCIS web interface.

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Enable WebDAV

WebDAV is disabled by default in Seafile. Edit the seafdav.conf file, located at /opt/seafile-data/seafile/conf/seafdav.conf for Docker installs, or /opt/seafile/conf/seafdav.conf for binary installs. Set 'enabled = true', set the port (default 8080), and restart Seafile (run 'docker compose restart' for Docker, or './seafile.sh restart' for binary installs).

Get your WebDAV URL

If Seafile is behind a reverse proxy: https://your-seafile-server.com/seafdav/. If connecting directly: https://your-seafile-server.com:8080/seafdav/

Prepare your credentials

Use your Seafile email address and password. Some Seafile versions support a dedicated WebDAV password. Check Settings in your Seafile web interface.

Connection Details

URL:https://YOUR_SEAFILE_SERVER/seafdav/

Username:your_email@example.com

Password:your_password

If not using a reverse proxy, add the port: https://YOUR_SEAFILE_SERVER:8080/seafdav/. All values are case-sensitive.

WebDAV must be enabled by admin

Seafile disables WebDAV by default. If you're not the server administrator, ask them to enable it in seafdav.conf and restart the service.

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Install the WebDAV app

In the TrueNAS SCALE web interface, go to Apps → Discover Apps and search for 'WebDAV'. Click Install to add the WebDAV community app.

Configure the WebDAV app

Set authentication to 'Basic Authentication' and choose a username and password. Configure the HTTPS port (default: 30035). Add at least one share pointing to your photo dataset.

Start the app

Click Install to deploy the container. The WebDAV app will start automatically and be accessible over your network.

Connection Details

URL:https://YOUR_TRUENAS_IP:30035/share_name

Username:your_username

Password:your_password

Default ports are 30034 (HTTP) and 30035 (HTTPS). Replace 'share_name' with the name you configured for your share.

Using TrueNAS CORE?

TrueNAS CORE has built-in WebDAV support under Services → WebDAV. The steps above are for TrueNAS SCALE, which uses the WebDAV community app from the Apps catalog.

TrueNAS Documentation

For detailed WebDAV configuration specific to your TrueNAS version, refer to the official TrueNAS documentation at truenas.com.

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Install Nextcloud from Community Apps

In the Unraid web interface, go to the Apps tab and search for 'Nextcloud'. Install 'Nextcloud' or 'Nextcloud AIO' (recommended) from Community Applications.

Configure Nextcloud

Complete the Nextcloud initial setup wizard. Create an admin account and configure the storage path to point to your photo share (e.g., /mnt/user/photos).

Get your WebDAV URL

Nextcloud provides built-in WebDAV. Your URL follows this format: https://YOUR_UNRAID_IP:PORT/remote.php/dav/files/USERNAME/

Connection Details

URL:https://YOUR_UNRAID_IP:PORT/remote.php/dav/files/USERNAME/

Username:your_nextcloud_user

Password:your_password

Replace PORT with the port configured for the Nextcloud container (commonly 443 or 8443) and USERNAME with your Nextcloud username.

Why Nextcloud?

Unraid doesn't have native WebDAV support. Running Nextcloud as a Docker container is the recommended approach. It provides full WebDAV access to your photo library with minimal setup.

Alternative: Apache WebDAV

You can also use the ApacheWebDAV Docker container from Community Apps for a lighter-weight WebDAV server without the full Nextcloud stack.

Set Up the Pixette App #

These steps are the same for all NAS types.

Configure Pixette

Open Pixette on your device and enter the connection details: URL, username, and password. All values are case-sensitive.

Browse and select folders

Tap 'Connect and browse folders', then select the folder containing your photos.

Index your files

Tap 'Index Now' to catalog all your photos and videos. This may take a few minutes depending on your collection size.

Quick Setup with QR Code

Skip manual typing. Generate a QR code with your NAS connection details and scan it with Pixette for instant configuration. Perfect for setting up multiple devices like photo frame tablets.

Secure and open source. Your credentials never leave your browser. The generator runs entirely client-side. view the source code for full transparency.

Can't see the generator? Open it directly on CodePen

Prefer manual entry? You can also generate QR codes with any standard QR library. Format the data as pipe-separated values: host|port|username|password|path

Troubleshoot WebDAV Connection #

If you're having trouble connecting Pixette to your NAS via WebDAV, try these steps. Connecting with Synology Photos instead? Make sure you're on DSM 7.0 or later, the Synology Photos package is installed, and the account you're signing in with does not have two-factor authentication (2FA) enabled.

1. Check that the URL is case-sensitive

WebDAV URLs are case-sensitive. Double-check every character, including folder names. For example: https://192.168.1.100:5006/Photos/Family

2. Test the connection from a computer first

Try connecting to your NAS via WebDAV from your computer using the exact same URL, username, and password. If your computer can't connect either, the issue is with your NAS configuration, not Pixette.

3. Use simple credentials for testing

Avoid special characters (like & £ @ #) in your password during initial setup. Use only letters and numbers until the connection works, then change to a stronger password.

4. Check if your IP is blocked

On Synology, go to Control Panel → Security → Account → Auto Block and verify that your device's IP address hasn't been blacklisted after failed login attempts.

5. Check the firewall and port

If the NAS firewall is enabled, make sure the WebDAV port (e.g. 5006) is allowed. Ensure your device is on the same local network as your NAS.

6. Check the WebDAV Server logs

On Synology, open the WebDAV Server package from Package Center to view logs. These logs often reveal the root cause of connection failures (wrong credentials, permission denied, etc.).

Still stuck? Contact me. I'm happy to help you troubleshoot.