Raspberry Pi'de PhotoPrism Nasıl Çalıştırılır
Bu yazı, PiMyLifeUp - How to Run PhotoPrism on the Raspberry Pi kaynağından Türkçe'ye çevrilerek hazırlanmıştır.
Bu eğitimde, Raspberry Pi'nizde PhotoPrism'i nasıl çalıştıracağınızı göstereceğiz.
![]()
PhotoPrism, Raspberry Pi'nizde fotoğraflarınızı etiketlemek ve kategorize etmek için yapay zeka kullanan açık kaynaklı ve ücretsiz bir fotoğraf uygulamasıdır.
PhotoPrism'in en umut verici özelliklerinden biri yapay zeka işlevselliğidir. Bu yapay zeka ile, fotoğraf uygulaması fotoğraflarınızı sınıflandırabilir, aile üyelerinizin ve arkadaşlarınızın yüzlerini tanıyabilir ve daha fazlasını yapabilir.
Hepsinden iyisi, PhotoPrism'de saklanan fotoğraflarınızı görüntülemek için yerel uygulamalar kurmanıza gerek yok. Bir web uygulaması olarak inşa edildiğinden, herhangi bir modern web tarayıcısı web sitesini cihazınızda yerel bir uygulamaymış gibi çalıştırabilir.
Bir docker konteyneri olarak sunulduğundan, PhotoPrism'i Raspberry Pi'de çalıştırmak basit bir süreç olacaktır.
Raspberry Pi'nizi PhotoPrism İçin Hazırlama
Raspberry Pi'mizde PhotoPrism kurup çalıştırmadan önce, ihtiyaç duyduğumuz her şeyin kurulu olduğundan emin olmalıyız.
Neyse ki PhotoPrism bir Docker konteyneri olarak sağlandığından, sadece Docker çalışma zamanına ve PhotoPrism'in yapılandırma dosyasını almak için bir araca ihtiyacımız var.
1. Docker'ı kurmadan önce, hem paket listemizi hem de kurulu paketlerimizi güncelleyeceğiz.
Her ikisini de güncellemek için yapmanız gereken tek şey terminalde aşağıdaki komutu çalıştırmaktır.
sudo apt update
sudo apt upgrade
2. Artık güncel olduğumuza göre, sonunda Pi'mizde PhotoPrism'i çalıştırmak için ihtiyaç duyduğumuz paketleri kurabiliriz.
Bizim durumumuzda, terminalde aşağıdaki komutu kullanarak sadece "wget"in kurulu olduğundan emin olmamız gerekiyor. Bu aracı, PhotoPrism GitHub'ından "docker-compose.yml" dosyasını almak için kullanacağız.
sudo apt install wget
3. Raspberry Pi'nizde "wget" paketi kurulu olduğunda, şimdi Docker kurma rehberimizi takip etmek isteyeceksiniz.
Bu, Raspberry Pi'nizde Docker'ın en son sürümünü çalışır hale getirecek.
PhotoPrism İçin Docker-Compose Dosyasını Yapılandırma
PhotoPrism'i kurmanın en karmaşık süreci "docker-compose.yaml" dosyasını yapılandırmaktır. Bu bölümde, örnek yapılandırma dosyasını alacağız ve neyi ayarlamanız gerektiğini göstereceğiz.
Raspberry Pi İçin PhotoPrism'i Yapılandırmaya Hazırlanma
1. Bu yapılandırma dosyasını saklayacağımız bir dizin oluşturmak için mkdir komutunu kullanarak başlayın.
Aşağıdaki komutla, "/opt/stacks/" dizini içinde "photoprism" adlı bir dizin oluşturacaksınız.
sudo mkdir -p /opt/stacks/photoprism
2. Dizin oluşturulduktan sonra, artık içine geçmek için cd komutunu kullanabilirsiniz.
cd /opt/stacks/photoprism
3. Artık doğru dizinde olduğumuza göre, bir sonraki adımımız PhotoPrism için Docker composer dosyasını Raspberry Pi'mize indirmektir.
Burada, daha önce kurduğumuz wget aracını "docker-compose.yml" dosyasını mevcut dizine indirmek için kullanacağız.
Bu komutun sürümünün 32-bit veya 64-bit bir sistem çalıştırmanıza bağlı olarak biraz değiştiğini lütfen unutmayın. Bu eğitimi takip ederken 64-bit bir işletim sistemi kullanmanızı öneririz.
64-Bit İşletim Sistemi
sudo wget https://dl.photoprism.app/docker/arm64/compose.yaml
32-Bit İşletim Sistemi
sudo wget https://dl.photoprism.app/docker/armv7/compose.yaml
PhotoPrism'i Yapılandırma
4. Artık docker compose dosyasına sahip olduğumuza göre, yapılandırmasında bazı ayarlamalar yapmak isteyeceğiz.
Bu dosyayı aşağıdaki komutu kullanarak düzenlemeye başlayabilirsiniz.
sudo nano compose.yaml
Kullanımı nispeten kolay olduğundan nano metin editörünü kullanmayı seviyoruz. Kendinizi en rahat hissettiğiniz metin editörünü kullanabilirsiniz.
5. Bu yapılandırma dosyasında değiştirmek isteyeceğiniz ilk seçenek, admin paneli için kullanılan ilk şifredir.
Dosyanın içinde aşağıdaki satırı bularak başlayın. Nano kullanırken dosyada arama yapmak için CTRL + W kullanabilirsiniz.
PHOTOPRISM_ADMIN_PASSWORD: "insecure"
Yukarıdaki metni bulduktan sonra, "insecure" kısmını seçtiğiniz güvenli bir şifreyle değiştirin. Seçtiğiniz şifre en az sekiz karakter uzunluğunda olmalıdır.
PHOTOPRISM_ADMIN_PASSWORD: "YOURPASSWORDGOESHERE"
6. Şifre daha güvenli bir şeyle değiştirildikten sonra, volume'leri yapılandırmaya geçebilirsiniz. PhotoPrism içinde erişilebilir olmasını istediğiniz herhangi bir ek klasör, bir volume olarak dahil edilmelidir.
O klasörün tüm alt dizinleri elbette erişilebilir olacaktır, bu yüzden tüm bir sürücüyü dahil etmek istiyorsanız, sadece bağlantı noktasını (mount path) eklemeniz gerekir.
Bu dosyanın içinde, aşağıdaki satırı bulmak isteyeceksiniz. Bu, nasıl yazıldıklarına dair bir örnek verir ve ek klasörleri nereye eklemeniz gerektiğini gösterir.
# "/host/folder:/photoprism/folder" # Example
Burada, volume, sol taraf (/host/folder) volume'e bağlanmasını istediğiniz Raspberry Pi'nizdeki klasör olacak şekilde belirtilir.
Sağ taraf (/photoprism/folder), konteyner içinde kullanılabilir hale getirileceği konumdur. PhotoPrism için yeni bir volume ayarlarken, konteyner yolu her zaman "/photoprism/" ile başlamalıdır.
7. Bunu göstermek için, bu listeye yeni bir volume ekleyeceğiz; "/mnt/holidayphotos" konumundaki harici sürücümüzü "/photoprism/holidayphotos"a bağlayacağız.
Bu satırı eklemek için, "volumes:" etiketinin altına aşağıdakini ekleyeceğiz.
- "/mnt/holidayphotos:/photoprism/holidayphotos"
Bunu kafa karıştırıcı bulursanız, lütfen aşağıya yorum yapın veya volume'lerle ilgili resmi PhotoPrism dokümantasyonuna göz atın.
8. Dosyada değişiklik yapmayı bitirdikten sonra, CTRL + X, ardından Y, sonra ENTER tuşuna basarak kaydedip çıkabilirsiniz.
Raspberry Pi'de PhotoPrism Çalıştırma
Artık "docker-compose.yml" dosyamızı oluşturduğumuza göre, PhotoPrism'i Raspberry Pi'de çalıştırmak çok basit.
Bu noktada, fotoğraf uygulamasını çalışır hale getirmek için yapmamız gereken tek şey tek bir komut çalıştırmaktır.
1. Aşağıdaki adımın çalışması için, hâlâ "docker-compose.yml" dosyasını oluşturduğumuz dizinde olduğunuzdan emin olmanız gerekecek.
Hâlâ doğru yerdeyseniz, artık aşağıdaki komutu kullanarak Raspberry Pi'nizde PhotoPrism'i başlatabilirsiniz.
sudo docker compose up -d
2. PhotoPrism için ilk başlatma süreci, Docker'ın gereken tüm konteyner imajlarını indirmesi gerektiğinden biraz zaman alabilir.
İndirme tamamlandıktan sonra, PhotoPrism cihazınızda hemen başlatılmalıdır.
PhotoPrism Web Arayüzünü Kullanma
Artık Raspberry Pi'nize PhotoPrism kurulduğuna göre, web arayüzüne erişebilirsiniz. Rehberin bu kısmı, web arayüzüne nasıl erişeceğinizi gösterir ve hızlı bir genel bakış sunar.
PhotoPrism Web Arayüzüne Erişim
1. Başlamadan önce, yerel ağınızın başka bir yerinden bağlanmak için Pi'nizin IP adresini bilmeniz gerekecek.
Cihazınızın IP'sini almanın en kolay yollarından biri hostname komutunu kullanmaktır.
hostname -I
Docker, kendi dahili kullanımı için birkaç IP adresi oluşturur. Bu nedenle, Pi'nizin yerel IP'si genellikle bu komutla listelenen ilk adres olur.
2. Artık Pi'nizin IP adresini bildiğimize göre, web tarayıcınızda aşağıdaki adrese gidebilirsiniz.
Varsayılan olarak, PhotoPrism Raspberry Pi'nizde 2342 portunu dinler.
http://IPADRESINIZ:2342/
3. PhotoPrism web arayüzünü yüklediğinizde, bir hesaba giriş yapmanız istenecektir. Varsayılan olarak, bu "admin" hesabı olacaktır.
Ekranın ortasındaki metin kutularını kullanarak (1.), kullanıcı adı olarak "admin" yazın. Ardından şifre için, bu rehberde daha önce "docker-compose.yml" dosyasında belirttiğiniz şifreyi kullanın.
Giriş bilgilerinizi yazdıktan sonra, "SIGN IN" düğmesine tıklayabilirsiniz (2.).

4. Artık sizi PhotoPrism ana sayfası karşılayacak. Bizim gibiyseniz ve sadece boş klasörleriniz varsa, gösterge paneli boş olacaktır.
Bu rehberde daha sonra PhotoPrism'e fotoğraf yükleme konusunda size rehberlik edeceğiz.

PhotoPrism Ayarlar Sayfasını Görüntüleme
1. PhotoPrism'in ayarlar sayfasına gitmek basit bir süreçtir ve kenar çubuğu kullanılarak kolayca erişilebilir.
Kenar çubuğunda bir dişli simgesi görmelisiniz, ayarlar sayfasına geçmek için bu simgeye tıklayın.

2. Artık ayarlar ekranında olduğumuza göre, her sayfayı ve ayarların ne için kullanıldığını inceleyelim.
Aşağıda gösterildiği gibi genel ayarlar sayfası, öncelikle kullanıcı arayüzünü kontrol eden seçeneklere odaklanır. Örneğin, bunu kenar çubuğundan menüleri gizlemek veya temayı ya da arayüz dilini değiştirmek için kullanabilirsiniz.

3. "Library" seçenekleri sayfası, PhotoPrism'in Raspberry Pi'de fotoğraflarınızı nasıl işleyeceğini kontrol etmenizi sağlar.
Örneğin, PhotoPrism'in yüklediğiniz fotoğraflar için otomatik olarak JPEG oluşturup oluşturmayacağını kontrol edebilirsiniz.

4. Gelişmiş sekmesi, adının söylediği şeyi içerir: gelişmiş seçenekler.
Bu seçenekler, PhotoPrism'in daha karmaşık kısımlarından bazılarını yapılandırmanızı sağlar. Örneğin, bunu belirli işlevleri devre dışı bırakmak veya PhotoPrism'in RAW dosyaları nasıl dönüştürdüğünü kontrol etmek için kullanabilirsiniz.

5. Sync sekmesiyle, Raspberry Pi'nizin PhotoPrism örneğine senkronize olmasını istediğiniz sunucuları kontrol edebilirsiniz.
Ayrıca WebDAV kullanarak PhotoPrism'e bağlanabilirsiniz. WebDAV, PhotoPrism'i sanki ağ üzerinden bağlı bir sürücüymüş gibi bağlamanızı sağlar.

6. Son seçenekler sayfası, giriş yapmak için kullandığınız PhotoPrism hesabı içindir. Bu sayfayla, hesabınızın şifresini değiştirebilirsiniz.
"docker-compose.yml" dosyasını yazarken ayarladığınız şifreyi hâlâ kullanıyorsanız, şimdi bunu değiştirmek için iyi bir zaman.

PhotoPrism ile Raspberry Pi'nize Fotoğraf Yükleme
1. PhotoPrism web arayüzü, fotoğrafları arayüzünden doğrudan Raspberry Pi'nize yüklemenizi sağlar.
Yükleme ekranına gitmek, arayüzün sağ üst köşesindeki bulut simgesine tıklamak kadar basittir.

2. Artık web arayüzünüzde aşağıda gösterilen ekranı görmelisiniz.
Sayfanın üstündeki metin kutusu (1.), yeni fotoğraflarınızı saklamak için yeni albümler seçmenizi veya oluşturmanızı sağlar. Yeni bir albüm oluşturmak istiyorsanız, yapmanız gereken tek şey adını yazıp ENTER tuşuna basmaktır.
Seçtiğiniz albümlerden memnun olduğunuzda, fotoğraflarınızı PhotoPrism'e yüklemeye başlamak için "UPLOAD" düğmesine tıklayın.

3. PhotoPrism'e fotoğraf yüklemek biraz zaman alabilir. Yükledikten sonra, Raspberry Pi'nizin her birini analiz etmesi gerekecek.
Süreç tamamlandıktan sonra, yeni görsellerinizin web arayüzünde görüntülendiğini görmelisiniz.

Raspberry Pi'de Photoprism'in Yeni Bir Sürümüne Güncelleme
Raspberry Pi'nizde Photoprism'i çalıştırmak için Docker kullanmanın temel bir avantajı, en son sürüme güncellemenin oldukça basit bir süreç olmasıdır.
1. İlk adımınız, rehberde daha önce "docker-compose.yml" dosyasını indirdiğimiz dizine geçmektir.
cd /opt/stacks/photoprism
2. Artık aşağıdaki komutu çalıştırarak Photoprism'in en son imajını Pi'mize çekmek için Docker kullanabiliriz.
docker compose pull
3. Photoprism'in yeni bir sürümü indirildikten sonra, aşağıdaki komutu çalıştırarak çalışan konteynerinizi bu yeni sürüme taşıyabilirsiniz.
docker compose up -d
Sonuç
Raspberry Pi projemizin bu noktasında, PhotoPrism fotoğraf uygulaması çalışıyor olmalı ve umarız fotoğraflarınızdan bazılarını yüklemişsinizdir.
PhotoPrism, üçüncü taraf bir hizmete güvenmeden fotoğraflarınızı kategorize etmenizi ve sunmanızı sağlayan etkileyici bir web uygulamasıdır.
PhotoPrism'i Raspberry Pi'de çalışır hale getirirken herhangi bir sorunla karşılaştıysanız, aşağıya yorum bırakın.