- PhotoPrism använder AI för att organisera dina foton lokalt med taggar, platser och avancerad sökning.
- Tydliga krav: 2-kärnig processor, 3 GB RAM, SSD för databas och cacher, och generöst med swap-utrymme.
- Enkel installation med Docker, montering av original, lagring och, om så önskas, import av mapp.
- Sekretess först: driftsätt bakom HTTPS med Traefik/Caddy om exponerad för internet och regelbundna säkerhetskopior.
¿Hur använder man PhotoPrism som ett privat AI-drivet galleri lokalt? Håll ditt fotobibliotek under kontrollUtan att förlita dig på det publika molnet är det inte längre en dröm: med PhotoPrism kan du skapa ett privat, AI-drivet fotogalleri på din egen dator eller server och bläddra igenom åratal av minnen utan att kompromissa med din integritet. Här är en detaljerad och praktisk förklaring av hur det fungerar, vad du behöver och hur du konfigurerar det lokalt med Docker.
För många är Google Foto extremt bekvämt, men i utbyte mot den bekvämligheten finns det rimliga tvivel om användningen av data. Om du är orolig för integritet Eller om du behöver följa regler som GDPR i professionella sammanhang är PhotoPrism ett kraftfullt alternativ: automatisk organisering, AI-drivna taggar, avancerad sökning och ett arbetsflöde utformat för stora samlingar, allt inom din befintliga infrastruktur.
Vad är PhotoPrism och varför ska man använda det lokalt?

PhotoPrism är en webbapplikation AI-driven fotohantering (med Google TensorFlow för klassificering) som känner igen personer, objekt, färger och scener för att tagga och organisera ditt bibliotek. Den skapades som en självhostad lösning så att du kan förvara dina foton och videor hemma eller på din egen server, samtidigt som du bevarar integriteten utan att offra moderna funktioner.
Det finns flera ledtrådar i dess DNA: kompatibilitet med RAW- och klassiska format som JPEG eller PNG; intelligent indexering med dubblettdetektering; navigering efter tidslinje, platser och taggar; och en sökmotor som låter dig kombinera filter efter kamera, färg, datum, land och till och med markera objekt som favoriter. Allt körs på din dator, med lokala cacher och utan att förlita dig på tredje part för analys.
Gränssnittet är en PWA, så det installeras på hemskärmen på datorer och mobila enheter. Det fungerar särskilt bra i Chrome, Chromium, Safari, Firefox och EdgeObservera att uppspelning av vissa video- och ljudkodekar (t.ex. AAC i H.264) kan variera beroende på webbläsare, vilket är normalt på den moderna webben.
En annan differentierande faktor är dess integration med WebDAV och externa tjänster: Du kan synkronisera från mobila enheter med appar som PhotoSyncoch även visa galleriet med lösenordsskyddade länkar som upphör att gälla. Om du dessutom vill ha kartor och platsdata använder PhotoPrism en omvänd geokodningstjänst och kartor med hög integritet som drivs av MapTiler; dessa resurser är utformade för att minimera exponering och förbättra cachningsprestanda. För att lära dig mer har vi inkluderat den här guiden om hur Organisera dina foton med AI utan molnlagring: PhotoPrism och lokala alternativ.
Krav, hårdvara och prestanda
För smidig lokal användning Minst två CPU-kärnor, 3 GB RAM och ett 64-bitarssystem rekommenderas. Utöver minimum är det lämpligt att matcha RAM-minnet med antalet kärnor och, för stora bibliotek, använda en lokal SSD för databasen och cacheminnen. Indexering är intensiv; med en SSD och bra swapping förbättras det dramatiskt.
Om din server har mindre än 4 GB swap, eller om du har satt mycket aggressiva minnes-/swap-gränser, Du kan uppleva oväntade omstarter När indexeraren behöver fler resurser (detta är vanligt med stora RAW-filer, 360-panoramor eller 4K-videor), aktivera eller öka växlingsutrymmet och ha tålamod: med många foton kan den initiala indexeringen ta dagar.
Angående databasen, PhotoPrism stöder SQLite 3 och MariaDB 10.5.12 och senareSQLite är lätt att komma igång med, men om du letar efter prestanda och skalbarhet är MariaDB ett bättre val. Stöd för MySQL 8 har tagits bort på grund av låg efterfrågan och brist på funktioner jämfört med MariaDB. Viktigt tips: undvik att använda taggen "senaste" i MariaDB-avbildningen; håll dig till stabila versioner som har testats noggrant.
Gällande plattformar distribueras appen överallt där Docker är tillgängligt: Linux, macOS och Windows med Docker DesktopFörutom FreeBSD, Raspberry Pi och många NAS-enheter finns molnalternativ via PikaPods eller DigitalOcean, även om vi kommer att fokusera på lokala lösningar här för integritet och kontroll.
Docker-installation steg för steg
Om du aldrig har använt DockerOroa dig inte: det är enkelt att distribuera med Docker Compose. YAML-filen kan placeras i vilken mapp du vill; först skapar du en katalog för PhotoPrism och sparar filen docker-compose.yml i den. Det viktiga är att tydligt definiera volymerna för original, lagring och, om så önskas, import.
Dessa är de tre typiska inställningarna: original (skrivskyddad eller läs-/skrivbar), lagring (cache, databas och sidofiler) och import (Valfritt). Du kan peka original till mappen där du redan har dina foton. Min rekommendation: håll lagringen separat från dina foton, så att du inte blandar databasen och cachen med dina original.
Grundläggande exempel på docker-compose med MariaDB och PhotoPrism (du kan anpassa det till din miljö):
version: '3.5'
services:
mariadb:
image: 'mariadb:11'
restart: unless-stopped
security_opt:
- 'seccomp:unconfined'
- 'apparmor:unconfined'
command: >-
--innodb-buffer-pool-size=512M
--transaction-isolation=READ-COMMITTED
--character-set-server=utf8mb4
--collation-server=utf8mb4_unicode_ci
--max-connections=512
--innodb-rollback-on-timeout=OFF
--innodb-lock-wait-timeout=120
environment:
MARIADB_AUTO_UPGRADE: '1'
MARIADB_INITDB_SKIP_TZINFO: '1'
MARIADB_DATABASE: 'photoprism'
MARIADB_USER: 'photoprism'
MARIADB_PASSWORD: 'cambia-esto'
MARIADB_ROOT_PASSWORD: 'cambia-esto'
volumes:
- './database:/var/lib/mysql'
photoprism:
image: 'photoprism/photoprism:latest'
depends_on:
- mariadb
stop_grace_period: 10s
security_opt:
- 'seccomp:unconfined'
- 'apparmor:unconfined'
ports:
- '2342:2342'
environment:
PHOTOPRISM_ADMIN_USER: 'admin'
PHOTOPRISM_ADMIN_PASSWORD: 'cambia-esto'
PHOTOPRISM_AUTH_MODE: 'password'
PHOTOPRISM_SITE_URL: 'http://localhost:2342/'
PHOTOPRISM_DEFAULT_TLS: 'true'
PHOTOPRISM_DATABASE_DRIVER: 'mysql'
PHOTOPRISM_DATABASE_SERVER: 'mariadb:3306'
PHOTOPRISM_DATABASE_NAME: 'photoprism'
PHOTOPRISM_DATABASE_USER: 'photoprism'
PHOTOPRISM_DATABASE_PASSWORD: 'cambia-esto'
PHOTOPRISM_ORIGINALS_LIMIT: 5000
PHOTOPRISM_JPEG_QUALITY: 85
PHOTOPRISM_DISABLE_WEBDAV: 'false'
PHOTOPRISM_DISABLE_TENSORFLOW: 'false'
PHOTOPRISM_DETECT_NSFW: 'false'
PHOTOPRISM_SIDECAR_JSON: 'true'
PHOTOPRISM_SIDECAR_YAML: 'true'
working_dir: '/photoprism'
volumes:
- '~/Pictures:/photoprism/originals'
- './storage:/photoprism/storage'
- './import:/photoprism/import'
Med filen klar, öppna en terminal i den mappen och kör: docker-compose up -dDen första initieringen laddar ner bilder och skapar databasen; ge det några minuter. Sedan börjar den indexera med docker compose exec fotoprisma fotoprisma indexSka uppdateras i framtiden: docker compose pull photoprism, docker compose stoppa fotoprisma y docker komponera upp -d –no-deps fotoprisma.
Standardinloggningsuppgifter: administratörsanvändarnamn och lösenordet som du definierar i miljövariabler. Kom ihåg att byta svaga lösenord så snart du loggar in för första gången. Om du ska importera mycket material är det värt att inaktivera ML-funktioner under den initiala indexeringen och sedan aktivera dem senare.
Säker åtkomst, lokala domäner och omvänd proxy
Om du ska exponera tjänsten utanför ditt nätverk, Sätt det alltid efter HTTPS med en omvänd proxy som Traefik eller Caddy. Utan TLS färdas allt i klartext och kan avlyssnas. Att upprätthålla integriteten är en del av planen: använd giltiga certifikat och omdirigera HTTP till HTTPS.
För att komma åt lokalt med en domän som photoprism.localhost utan en port har du två alternativ: mappa en standardport på värden (till exempel 80:2342, endast för lokal användning) eller konfigurera Traefik att lyssna på 80 och dirigera till tjänsten på 2342. Se till att containeretiketterna inkluderar routern, startpunkten och den interna tjänstporten. Ett typiskt mönster med Traefik skulle vara att definiera värdregeln, webbstartpunkten och peka tjänstporten till 2342.
En annan viktig punkt är brandväggen: tillåter inkommande anslutningar till de portar du använder (webb och https) och utgående till geokodnings-API:et och Docker vid behov. Om du blockerar dessa utgående anslutningar kommer kartorna och platserna inte att fungera korrekt.
Organisation, AI och funktioner som gör skillnad
PhotoPrism arbetar med en kraftfull katalog och sidovagnar; Du kan skriva metadata i JSON och YAML Vid sidan av dina original, så att det inte enbart beror på databasen. Klassificering med TensorFlow (ansikten, objekt, scener och NSFW) snabbar upp sökningar, och att bestämma om känsliga foton ska markeras som privata är lika enkelt som att aktivera en inställning.
För att bibehålla prestandan kan du justera miniatyrbildernas kvalitet och storlek, videokodekar, bithastighetsgränser och omskalning. FFmpeg konfigureras av variabler Och om din hårdvara stöder det kan du delegera till Intel QSV, Nvidia, Apple eller VAAPI för accelererad omkodning. Med bara några få klick kan du gå från ett grundläggande arbetsflöde till ett som är skräddarsytt för ditt system.
Navigeringen är smidig: tidslinje, album, taggar, favoriter och platser. Den avancerade sökpanelen Den låter dig filtrera efter kamera, datum, länder, färger eller personer. Om du kommer från kaotiska bibliotek hjälper dublettdetektering och metadatanormalisering dig att skapa ordning utan problem.
På mobila enheter finns det ingen officiell app, men du kan använda PWA eller synkronisera med WebDAV med hjälp av appar som PhotoSync. PWA är mycket praktiskDen installeras som en inbyggd app, vilket gör att du slipper använda en webbläsare varje gång. Upplevelsen på Android TV eller Google TV är dock begränsad, precis som med de flesta lösningar inom den här sektorn. Det mest pålitliga alternativet är fortfarande att använda en webbläsare på en bärbar dator ansluten till TV:n om du bekvämt vill titta på foton med din familj.
Vem drar mest nytta av PhotoPrism
Professionella fotografer Med tusentals RAW-filer hittar du en kraftfull bundsförvant: indexering, sökning efter objektiv eller kamera, dubblettdetektering och sidofunktioner för att undvika att ändra originalet. Att ha din samling kontrollerad, taggad och konsoliderad sparar timmar av arbete på medellång sikt.
till grafiska formgivare och kreatörerFärgkodade etiketter och objekttaggar hjälper dig att snabbt hitta visuell inspiration. Att visa saker efter ögonblick och använda en tidslinje hjälper dig att hämta idéer och material utan att tappa koll.
Inom fastighetssektorn, fastighetsmäklare De kan kategorisera fastigheter efter plats, datum eller taggar, och dela album med skyddade länkar som går ut. Integritet är nyckeln här, och att ha kontroll över servern är ett plus.
Digitala marknadsföringsteam De uppskattar ett organiserat bibliotek med filter för kampanjer, datum och länder. Stöd för flera användare och användningen av sidopaket gör det enkelt att undvika att förstöra originalen och att dela interna samlingar utan att exponera dem externt.
till resenärer, digitala arkivarier och utvecklareFördelarna sträcker sig från interaktiva kartor till möjligheten att integrera galleriet med andra tjänster via WebDAV. Om efterlevnad också är ett problem, hjälper det dig att hålla informationen i din egen infrastruktur med GDPR och interna policyer.
Populära alternativ och hur de passar in
Immich slår hårtDet påminner mycket om Google Foto, med en sömlös tidslinje, nyckelbaserade favoriter, mobilsynkronisering och semantisk sökning efter koncept eller färger. Att importera från Google Takeout är otroligt enkelt med verktyg som Immich-Go. Nackdelen är att Android TV-appen är begränsad; för TV-sessioner är en webbläsare på en bärbar dator att föredra.
Inom området produktivitetssviter, Nextcloud Photos och Memories-pluginet De erbjuder ett bra alternativ om du redan använder Nextcloud. Recognize-appen erbjuder ansiktsigenkänning, och Imaginary och Preview Generator snabbar upp förhandsvisningar. Gränssnittet är funktionellt, även om snabba åtgärder som att markera favoriter inte är lika omedelbara som i andra alternativ.
Fotostruktur Den erbjuder ett annorlunda tillvägagångssätt, med en startskärm som visar ett slumpmässigt urval av foton för att hjälpa dig återupptäcka ditt arkiv. Den är snabb och fräsch, men dess Plus-läge låser upp funktioner som favoriter och ansiktsigenkänning, vilket kan skrämma bort de som letar efter allt gratis och lokalt.
Piwigo, Photoview, Lychee eller Photonix De täcker olika scenarier: enkla gallerier, grundläggande igenkänning eller organisation med taggar. Om din prioritet är tidslinjen och snabba genvägar kan de misslyckas. LibrePhotos ser mycket lovande ut på pappret, men implementeringen kan vara mer manuell och det fungerar inte alltid smidigt på enkla datorer.
Upp Plex har lanserat Plex Foton Plex, som för närvarande är i beta för iOS, Android och webben, är ett intressant alternativ om du redan är en Plex-användare, även om det för närvarande saknar en polerad inbyggd Android TV-app. Ente, å andra sidan, har öppen källkod för sin kod och ståtar med end-to-end-kryptering; det ser mycket lovande ut, även med skrivbordsklienter, även om dess självhosting kräver viss teknisk kunskap.
Vanliga frågor för Docker-nybörjare
Var lägger jag YAML-filen?I vilken mapp du vill. Det viktiga är att köra Docker Compose-kommandona från den katalogen så att den läser korrekt YAML. Håll docker-compose.yml och undermappar som storage, database och import tillsammans så att du har allt lättillgängligt.
Ska jag montera min nuvarande fotomapp? Ja, mappa din fotomapp till /photoprism/originals. Om du föredrar att inte ge skrivbehörighet kan du montera den skrivskyddad, men du förlorar redigeringsmöjligheterna för metadata på plats. PhotoPrism undviker också att vidröra originalfilerna med sidofiler.
Vart tar databasen och cachen vägen? Det är bäst att lagra dem utanför din fotomapp, i en separat sökväg som du mappar till /photoprism/storage (och, om du använder MariaDB, till ./database i DBMS-containern). På så sätt blandar du inte cachar och databaser med dina originalfiler.
Hur man monterar en mapp i DockerI volymnyckeln använder du formatet host_path:container_path. Till exempel ~/Pictures:/photoprism/originals. Kontrollera behörigheterna för användaren som kör containern; använd vid behov variablerna PHOTOPRISM_UID och PHOTOPRISM_GID eller användardirektivet för att justera behörigheterna.
Behöver vi Traefik eller Caddy? Gör bara detta om du vill ha automatisk TLS, rena domäner och sökvägar, eller om du exponerar tjänsten för internet. Lokalt räcker det med att mappa port 2342. Om du använder Traefik, definiera värden, webbingångspunkten och den interna porten 2342 för tjänsten; på så sätt kan du komma åt den med photoprism.localhost utan att lägga till :2342.
Support, uppdateringar och community

Projektet syftar till att vara det mest integritetsvänliga alternativet Och den har en dynamisk färdplan. De strävar efter en policy med noll fel och sätter därför inga fasta datum för nya funktioner: takten beror också på finansiering och stöd från samhället. Om det passar dig, påskyndar medlemskapet utvecklingen av det som intresserar dig mest.
För att undanröja eventuella tvivel har du Diskussioner på GitHub och communitychattSilver-, Gold- och Platinum-medlemmar kan också kontakta teknisk support. Innan du öppnar en felrapport, kontrollera felsökningschecklistorna; ofta är problemet ett lokalt konfigurationsproblem och kan lösas snabbt.
I uppdateringar kan du automatisera med Vakttorn Om du känner dig bekväm med det, så är det bra; annars är det bättre att använda en pull-stop-and-up-process när en stabil version släpps. I seriösa miljöer, använd fasta versioner och undvik att använda den senaste versionen, både i PhotoPrism och MariaDB, för att säkerställa kontrollerade uppdateringar.
Om du är bekymrad över kartor och omvänd geokodning, PhotoPrism och MapTiler Dessa tjänster erbjuder en mycket hög nivå av integritet. Deras användning omfattas av projektet, med cachning för att förbättra prestanda och förhindra att dina frågor överexponeras.
Slutligen, kom ihåg det uppenbara men viktiga: Att göra säkerhetskopior är inte valfrittOm du hanterar familjeminnen eller klientmaterial är ansvaret ditt. Säkerhetskopiera din databas, lagring och, viktigast av allt, dina originalfiler på minst två olika platser. Undvik billiga USB-enheter eller långsamma nätverksmappar för din databas.
I detta skede, PhotoPrism Han har förtjänat positionen Som en robust lösning för att ha ditt eget lokala Google Foto: AI för sortering, SSD-hastighet, sidovagnar för att bevara original och en polerad PWA. Om du prioriterar njutning framför katalogisering kan du dras till alternativ som Immich för deras gränssnitt; om noggrann organisation är din grej glänser PhotoPrism. Oavsett dina behov, med en bra Docker Compose-installation, tillräckligt med växlingsutrymme, HTTPS för internetåtkomst och säkerhetskopior, kommer du att ha ett stabilt system installerat för kommande år.
Brinner för teknik sedan han var liten. Jag älskar att vara uppdaterad inom branschen och framför allt kommunicera den. Det är därför jag har varit dedikerad till kommunikation på teknik- och videospelswebbplatser i många år nu. Du kan hitta mig som skriver om Android, Windows, MacOS, iOS, Nintendo eller något annat relaterat ämne som du tänker på.