Skip to main content
Version: 2.5.0

Try it with the demo servers

You can try every Immich and Nextcloud source without running your own server. Public demo servers hold a small library of photos, and the examples in these docs and the plugin's showcase notes (Create showcase notes command) point at them.

Read-only, for trying the plugin only

The demo servers are read-only: the credentials below can view photos but cannot change anything. They are run by the plugin's author, so your requests (and your IP address) reach that server. Don't rely on them for anything beyond trying the plugin; they may change or go away.

Share links need no connection. Paste any of these into a gallery block:

SourceURLPassword
immich-share (Landscapes album)https://demo-immich.mkshp.dev/share/7XBAej6IyThZOS7izb78XcEJX7QhYwQBmxtHxaBz7TaaqiP5pxWyZQrN6TIvUGRhI9g—
immich-share (Travel album)https://demo-immich.mkshp.dev/share/RAHL6jLQTkqIDaSYjdlHdcbJ4W25u002dyorCdqYVDmoar8xyB7wiE8GARi4QH2eqWwgallery-demo
nextcloud-share (folder)https://demo-nextcloud.mkshp.dev/s/DAxM47SmHesMTqa—
nextcloud-share (folder)https://demo-nextcloud.mkshp.dev/s/ZSBpcMLfaQPCi2Ygallery-demo
nextcloud-share (Photos app album)https://demo-nextcloud.mkshp.dev/apps/photos/public/wD9fLmI1TP6KEq76Yvs9fZrBdfDu8gfc—
```obs-gallery
sources:
  - type: immich-share
    url: https://demo-immich.mkshp.dev/share/7XBAej6IyThZOS7izb78XcEJX7QhYwQBmxtHxaBz7TaaqiP5pxWyZQrN6TIvUGRhI9g
view:
  type: justified
```

Connections (for immich and nextcloud sources)​

The quickest way to get them: run the Create showcase notes command and choose Add connections. The plugin adds both connections to your settings (it never changes an existing connection with the same key) and writes example notes that use them.

To add them by hand instead, use Settings → Gallery View → Providers (see Settings). Use exactly these keys, because the docs examples and showcase notes refer to them. Remove the connections there when you are done trying the plugin.

Immich​

FieldValue
Keyimmich-demo
Base URLhttps://demo-immich.mkshp.dev
API keyY8jMqmnnv5ME9wJl78U1D4cIgSGcigtMemcgWMxxE

What's on the server: 57 assets (55 photos, 2 videos) taken between January 2024 and October 2026, 10 of them favorites.

KindValues
AlbumsLandscapes 0fe76d50-18b3-4f74-8f7c-3ede043982de (9) · City 0a33a817-9389-45f5-a99d-6ac12f56dc7f (6, one video) · Travel 882fef37-436a-49c1-af1a-e444d0216ee0 (7, one video) · People 9a714fd1-36f8-4b3a-ba48-2f3101895dee (25)
TagsPhotography (30) · Nature (9) · Architecture (5) · Portraits (25)
PeopleAlice · Bob · Carol · Dave (7 photos each)

Nextcloud​

FieldValue
Keynextcloud-demo
Base URLhttps://demo-nextcloud.mkshp.dev
Usernamedemo
App passwordpsMXy2P4j2YZSjJuALSukdyzkjhIBAAqgUkQVFavPQPyRqkZfrkAXZhIknna8IIpLHsVgr8M

What's on the server: 40 images (JPEG, PNG and WebP, 14 KB to 2.5 MB) in /Gallery-Demo/Landscapes, /Gallery-Demo/City and /Gallery-Demo/Camera. Camera uses phone-style names (IMG_2024…, IMG_2025…) for trying filenameFilter, and modified dates range from 2024 to 2026 for trying modifiedAfter / modifiedBefore.

```obs-gallery
sources:
  - type: nextcloud
    connection: nextcloud-demo
    path: /Gallery-Demo/Camera
    filenameFilter: "IMG_2024*"
view:
  type: masonry
```

Photo credits​

Every photo and video on the demo servers is free to use. Thanks to the photographers below.

  • CC0 1.0 (deed): 51 photos from StockSnap and 2 videos from Wikimedia Commons. The videos were converted to MP4 without audio, and some Nextcloud copies were resized or converted to PNG/WebP.
  • Unsplash License: 44 photos from Unsplash, served by Lorem Picsum. The IMG_… names in the Nextcloud Camera folder are made up for the filenameFilter examples; the dates in them are not when the photos were taken.

The names Alice, Bob, Carol and Dave in the Immich demo are invented labels for the face-recognition examples, not the names of the people photographed.

Immich demo (57 assets)
FileAuthorSourceLicence
picsum-30.jpgShyamanta BaruahUnsplashUnsplash License
picsum-31.jpgHow-Soon NguUnsplashUnsplash License
picsum-32.jpgRodrigo MeloUnsplashUnsplash License
picsum-33.jpgAlejandro EscamillaUnsplashUnsplash License
picsum-34.jpgAleks DorohovichUnsplashUnsplash License
picsum-35.jpgShane ColellaUnsplashUnsplash License
picsum-36.jpgVadim SherbakovUnsplashUnsplash License
picsum-37.jpgAustin NeillUnsplashUnsplash License
picsum-38.jpgAllyson SouzaUnsplashUnsplash License
picsum-39.jpgLuke ChesserUnsplashUnsplash License
picsum-40.jpgRyan McguireUnsplashUnsplash License
picsum-41.jpgNithya RamanujamUnsplashUnsplash License
picsum-42.jpgLuke ChesserUnsplashUnsplash License
picsum-43.jpgOleg ChursinUnsplashUnsplash License
picsum-44.jpgChristopher SardegnaUnsplashUnsplash License
picsum-45.jpgAlan HavertyUnsplashUnsplash License
picsum-46.jpgJeffrey KamUnsplashUnsplash License
picsum-47.jpgChristopher SardegnaUnsplashUnsplash License
picsum-48.jpgLuke ChesserUnsplashUnsplash License
picsum-49.jpgMargaret BarleyUnsplashUnsplash License
picsum-50.jpgTyler WanlassUnsplashUnsplash License
picsum-51.jpgIreneuiliaUnsplashUnsplash License
picsum-52.jpgCierraUnsplashUnsplash License
picsum-53.jpgJ DuclosUnsplashUnsplash License
picsum-54.jpgNicholas SwansonUnsplashUnsplash License
picsum-55.jpgTyler WanlassUnsplashUnsplash License
picsum-56.jpgSebastian MullerUnsplashUnsplash License
picsum-57.jpgNicholas SwansonUnsplashUnsplash License
picsum-58.jpgTony NaccaratoUnsplashUnsplash License
picsum-59.jpgArt WaveUnsplashUnsplash License
stocksnap-01.jpgDirect MediaStockSnapCC0 1.0
stocksnap-02.jpgDirect MediaStockSnapCC0 1.0
stocksnap-03.jpgDirect MediaStockSnapCC0 1.0
stocksnap-04.jpgDirect MediaStockSnapCC0 1.0
stocksnap-05.jpgDirect MediaStockSnapCC0 1.0
stocksnap-06.jpgDirect MediaStockSnapCC0 1.0
stocksnap-07.jpgDirect MediaStockSnapCC0 1.0
stocksnap-08.jpgMike MoloneyStockSnapCC0 1.0
stocksnap-09.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-10.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-11.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-12.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-13.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-14.jpgMatt MoloneyStockSnapCC0 1.0
stocksnap-15.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-16.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-17.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-18.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-19.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-20.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-21.jpgKristin HardwickStockSnapCC0 1.0
stocksnap-22.jpgDirect MediaStockSnapCC0 1.0
stocksnap-23.jpgDirect MediaStockSnapCC0 1.0
stocksnap-24.jpgDirect MediaStockSnapCC0 1.0
stocksnap-25.jpgDirect MediaStockSnapCC0 1.0
ocean-sommaroy.mp4Netha HussainWikimedia CommonsCC0 1.0
city-timelapse-albury.mp4ThennickeWikimedia CommonsCC0 1.0
Nextcloud demo, /Gallery-Demo (40 files)
FileAuthorSourceLicence
Landscapes/mountain-mountains-landscape-1.jpgMatt FloresStockSnapCC0 1.0
Landscapes/mountain-mountain-landscape-2.webpKristoffer FredrikssonStockSnapCC0 1.0
Landscapes/mountain-mountain-landscape-3.jpgRobert LukemanStockSnapCC0 1.0
Landscapes/mountain-mountain-landscape-4.pngJohannes PlenioStockSnapCC0 1.0
Landscapes/lake-lake-landscape-1.jpgTricia GrayStockSnapCC0 1.0
Landscapes/lake-lake-landscape-2.webpSergei GussevStockSnapCC0 1.0
Landscapes/lake-lake-landscape-3.jpgJoe deSousaStockSnapCC0 1.0
Landscapes/lake-lake-landscape-4.pngTricia GrayStockSnapCC0 1.0
Landscapes/forest-enchanting-forest-1.jpgJohannes PlenioStockSnapCC0 1.0
Landscapes/forest-dock-lake-2.webpTj HolowaychukStockSnapCC0 1.0
Landscapes/forest-girl-woman-3.jpgCaleb FrithStockSnapCC0 1.0
Landscapes/beach-beach-sunset-1.jpgKen CooperStockSnapCC0 1.0
Landscapes/beach-beach-sunset-2.webpFré SonneveldStockSnapCC0 1.0
Landscapes/beach-beach-sunset-3.jpgKristin HardwickStockSnapCC0 1.0
City/skyline-city-skyline-1.jpgJoe deSousaStockSnapCC0 1.0
City/skyline-city-skyline-2.webpMatt BangoStockSnapCC0 1.0
City/skyline-city-skyline-3.jpgMatt BangoStockSnapCC0 1.0
City/skyline-city-skyline-4.pngMatt BangoStockSnapCC0 1.0
City/skyline-city-skyline-5.jpgBurstStockSnapCC0 1.0
City/skyline-city-skyline-6.jpgMike MoloneyStockSnapCC0 1.0
City/street-city-street-1.jpgZachary StainesStockSnapCC0 1.0
City/street-city-streets-2.webpJeffrey BettsStockSnapCC0 1.0
City/street-city-streets-3.jpgJeffrey BettsStockSnapCC0 1.0
City/street-city-street-4.pngLerone PietersStockSnapCC0 1.0
City/street-city-streets-5.jpgKevin LeeStockSnapCC0 1.0
City/street-city-streets-6.jpgMarkus SpiskeStockSnapCC0 1.0
Camera/IMG_20240103_222.jpgArvee MarieUnsplashUnsplash License
Camera/IMG_20240306_037.jpgTina RatajUnsplashUnsplash License
Camera/IMG_20240308_259.jpgLukas SchweizerUnsplashUnsplash License
Camera/IMG_20240511_074.jpgChristian BardenhorstUnsplashUnsplash License
Camera/IMG_20240716_111.jpgBen MooreUnsplashUnsplash License
Camera/IMG_20240921_148.pngIlham RahmansyahUnsplashUnsplash License
Camera/IMG_20241126_185.jpgDyaa EldinUnsplashUnsplash License
Camera/IMG_20250105_444.pngZugrUnsplashUnsplash License
Camera/IMG_20250310_481.jpgZugrUnsplashUnsplash License
Camera/IMG_20250513_296.pngFlorian KlauerUnsplashUnsplash License
Camera/IMG_20250515_518.jpgBrian GonzalezUnsplashUnsplash License
Camera/IMG_20250718_333.jpgZwaddiUnsplashUnsplash License
Camera/IMG_20250923_370.jpgKenneth ThewissenUnsplashUnsplash License
Camera/IMG_20251128_407.jpgGabe RodriguezUnsplashUnsplash License