UYAP Doküman Editörü kurulumu ve kullanımı: Windows, Mac ve Linux

Resmî indirme adresi ve güncel sürümler

Resmî adres https://www.uyap.gov.tr/UYAP-Editor. Sayfadaki bağlantılar dosyaları Adalet Bakanlığı'nın rayp.adalet.gov.tr sunucusundan indirir. Aşağıdaki tabloyu 27.09.2026'da bu sayfadan aldık; sürüm değişirse resmî sayfa esastır.

İndirdiğiniz dosyanın adı tablodakiyle aynı olmalı. Adı farklıysa ya da dosya bir yazılım indirme sitesinden geldiyse kurmayın, resmî sayfadan yeniden indirin.

UYAP Editör Windows'a nasıl kurulur?

UYAP Doküman Editörü Windows'a, resmî sayfadan indirilen UKI_V5.4.20.exe ya da UKI_V5.4.20.msi kurulum dosyası çalıştırılarak kurulur; kurulumdan sonra program "Uyap Kelime İşlemci" adıyla görünür. Resmî sayfa Windows için ayrı bir Java kurulumu istemiyor.

Kurulum adımları

1. uyap.gov.tr/UYAP-Editor sayfasından Windows için UKI_V5.4.20.exe'yi indirin. Bürodaki bilgisayarlara yazılımı merkezi olarak dağıtan bir BT biriminiz varsa aynı sürümün .msi paketi daha uygundur.
2. İndirilen dosyaya çift tıklayın ve kurulum sihirbazını tamamlayın. Windows yönetici onayı isterse verin.
3. Kurulum bitince bir UDF dosyasına çift tıklayın. Belge editörde açılıyorsa kurulum tamam.

UDF dosyalarının çift tıklayınca editörde açılması

UDF'ye çift tıkladığınızda başka bir program açılıyor ya da Windows "bu dosyayı nasıl açmak istiyorsunuz?" diye soruyorsa uzantı editöre bağlanmamış demektir. Bunu düzeltmek için Ayarlar → Uygulamalar → Varsayılan uygulamalar yoluna girin, arama kutusuna .udf yazıp listeden UYAP editörünü seçin.

Dosyanın gerçek uzantısını görmek de işe yarar: WhatsApp Web gibi bazı yerlerden inen dosyalar belge.udf.zip adıyla kaydedilir. Windows 11'de Dosya Gezgini'nde Görünüm → Göster → Dosya adı uzantıları seçeneğini işaretlerseniz fark görünür. Sondaki .zip'i silmek çoğu zaman yeter.

Kaldırma ve temiz kurulum

Editör açılmıyor ya da imza atmıyorsa ve tercih dosyalarını sıfırlamak işe yaramadıysa temiz kurulum yapın: Denetim Masası'ndan "Uyap Kelime İşlemci"yi kaldırın, bilgisayarı yeniden başlatın, C:\Uyap klasörünü başka bir yere yedekleyip silin ve son sürümü yeniden kurun. Bu, resmî sayfanın önerdiği sıra; yedeklemeyi atlamayın.

Windows'ta sık görülen kurulum hataları

UYAP Editör Mac'e nasıl kurulur? (Apple Silicon ve Intel)

UYAP Doküman Editörü Mac'e, işlemciye uygun zip paketi (Apple Silicon ya da Intel, sürüm 5.4.21) resmî sayfadan indirilip içindeki uygulama Uygulamalar klasörüne taşınarak kurulur. 5.4.21 Java istemez; yalnızca macOS Big Sur 11 ve öncesi için ayrılan Intel sürümü (5.4.20) uyumlu bir Java kurulumu gerektirir.

Doğru paketi seçin

Çip ya da işlemci adı Apple menüsü → Bu Mac Hakkında penceresinde yazar. Yanlış paket kurulursa uygulama açılmayabilir, açılsa da yavaş çalışabilir; emin değilseniz indirmeden önce bu pencereye bakın.

Kurulum adımları

1. İşlemcinize uygun zip'i resmî sayfadan indirin.
2. İndirilenler klasöründe zip'e çift tıklayın; çıkan uygulamayı Uygulamalar klasörüne sürükleyin.
3. Editörü Uygulamalar klasöründen açın.
4. macOS "uygulama açılamıyor" türünden bir güvenlik uyarısı gösterirse ve dosyayı yalnızca resmî sayfadan indirdiğinizden eminseniz, Apple'ın anlattığı yolu izleyin: Sistem Ayarları → Gizlilik ve Güvenlik bölümünü açın, sayfayı aşağı kaydırıp "Yine de Aç" düğmesine, ardından çıkan uyarıda "Aç"a tıklayın. Editörü kendimiz kurmadık, o yüzden bu uyarının çıkıp çıkmadığını doğrulayamadık.

Bütün UDF'lerin editörle açılması

Finder'da bir UDF seçin ve Dosya → Bilgi Ver penceresini açın. "Şununla Aç" bölümünden editörü seçip "Tümünü Değiştir"e tıklarsanız bundan sonra bütün UDF'ler editörde açılır. Dosya adının sonunu görmek isterseniz Finder → Ayarlar → İleri Düzey'de "Tüm dosya adı uzantılarını göster"i işaretleyin; .udf.zip olarak inmiş dosyalar böylece fark edilir.

Mac'te ayar dosyalarını sıfırlama

Editör açılmıyor ya da imza atmıyorsa Finder'da Git → Ana Klasör'e gidin, gizli klasörleri göstermek için Cmd+Shift+. tuşlarına basın ve .uki klasöründeki acilisdegerleri.xml, tercihler.xml ve lastOpened.xml dosyalarını silin. Bunlar belgeleriniz değil, açılış ayarlarıdır.

UYAP Editör Linux'a nasıl kurulur? (Pardus, Debian, Ubuntu)

UYAP Doküman Editörü'nün Linux sürümü resmî olarak "Pardus ve Debian tabanlı sistemler" için, 64 bit x86 (amd64) işlemcilere yönelik uyapeditor_5.4.20_amd64.zip paketiyle yayımlanıyor; yazıcıdan çıktı almak için cups-bsd paketi de gerekiyor. Ubuntu, Linux Mint gibi dağıtımlar için ayrı bir resmî açıklama yok.

Pardus ve Debian'da kurulum adımları

1. Resmî sayfadan uyapeditor_5.4.20_amd64.zip'i indirin.
2. Zip'i açın. Dosya yöneticisinde sağ tık → "Buraya çıkar" ya da uçbirimde unzip uyapeditor_5.4.20_amd64.zip.
3. İçinden bir .deb paketi çıkıyorsa Pardus'ta çift tıklayarak paket kurucuyla ya da uçbirimde sudo apt install ./dosya-adi.deb komutuyla kurun. Önceki sürümlerde zip'ten .deb çıktığını yazan resmî olmayan anlatımlar var; bu sürümün içeriğini kendimiz açıp doğrulamadık.
4. Yazdırma için: sudo apt install cups-bsd. Resmî nota göre Pardus 17.2 için bu paket zip'in içine eklenmiş.
5. Editörü uygulama menüsünden açın, bir UDF'yi Dosya → Aç ile açarak deneyin.

Pardus uygulama mağazası

Pardus'un uygulama mağazası (apps.pardus.org.tr) da "UYAP Editör" adlı bir kayıt listeliyor. Oradan kurmak kolay, ama sürümün resmî sayfadaki 5.4.20 ile aynı olup olmadığını doğrulayamadık. Haziran 2026'dan sonra imza için güncel sürüm şart olduğundan, mağazadan kurduysanız sürüm numarasını resmî sayfayla karşılaştırın.

Ubuntu, Linux Mint ve diğer dağıtımlar

Ubuntu ve Linux Mint Debian tabanlı olduğu için aynı paket çoğu zaman kurulabilir, ama resmî destek kapsamı "Pardus ve Debian tabanlı sistemler" diye tanımlanmış ve biz bu dağıtımlarda test etmedik. ARM işlemcili cihazlar (ör. Raspberry Pi) için paket yok. Kurulum sonrası sorun yaşarsanız ayarları sıfırlamak için ev dizininizdeki gizli .uki klasörüne bakın (ls -a ~ ile görünür).

UYAP Editör için Java gerekir mi?

Güncel sürümlerin çoğunda hayır, ama cevap sisteme ve sürüme göre değişiyor. Resmî sayfaya göre Mac'teki 5.4.21 Java istemiyor; Big Sur 11 ve öncesi için ayrılan 5.4.20 ise uyumlu bir Java kurulumu istiyor.

Windows'taki 5.4.20 için resmî sayfada Java notu yok. Bağımsız bir açık kaynak proje, resmî Windows paketinin kendi Java 8 ortamıyla geldiğini yazıyor; bunu resmî bir kaynakta doğrulayamadık. İmza tarafında kullanılan Adalet e-İmza Uygulaması da, resmî sayfasına göre, ihtiyaç duyduğu Java çalışma ortamını kendi içinde taşıyor.

İnternette hâlâ dolaşan "önce 32 bit Java kurun" adımı, resmî yardım sayfasının 2015 tarihli v4.0.14 dönemi metninden geliyor. Vatandaş Portal'ın sorun giderme belgesindeki iki Java hatası da eski kurulumlarda görülür. "'Javaw' Windows tarafından bulunamıyor" hatası Java'nın kurulu olmadığını ya da yolunun PATH'e eklenmediğini gösterir. "Application Blocked by Java Security" uyarısı için belge, Java Denetim Masası'nda General → Temporary Internet Files → View yolundan uygulamaların silinmesini öneriyor. Biz iki durumda da önce güncel editörü kurmanızı öneririz; çoğu zaman Java'yla uğraşmaya gerek kalmaz.

Java'yı kurmanız gerekiyorsa: adım adım

Bu adımlar yalnızca Big Sur 11 ve öncesindeki Intel Mac'ler için ve eski bir editör sürümünü kullanmak zorunda kalan Windows bilgisayarlar için. Resmî sayfa hangi Java sürümünün "uyumlu" olduğunu belirtmiyor. Aşağıda Oracle'ın genel kurulum yolunu anlatıyoruz.

1. Java'yı yalnızca Oracle'ın resmî adresinden, java.com/tr/download sayfasından indirip kurun.
2. Kurulumu kontrol edin. Windows'ta komut istemini (cmd), Mac'te Terminal'i açıp java -version yazın. Bir sürüm numarası görüyorsanız Java kurulu ve bulunabiliyor demektir.
3. Windows'ta "komut bulunamadı" ya da editörde "'Javaw' bulunamıyor" hatası alıyorsanız Java'nın bin klasörünü PATH'e ekleyin. Resmî yardım sayfası 64 bit Windows için şu yolu tarif ediyor: Program Dosyaları (x86) → Java → jre klasörünün yolunu kopyalayın. Sonra Bilgisayar'a sağ tıklayıp Özellikler → Gelişmiş sistem ayarları → Ortam Değişkenleri yolunu izleyin. Path değişkenini seçip "Düzenle"ye basın ve kopyaladığınız yolu en başa ekleyin. Eski Windows sürümlerinde değerler tek satırdır; orada yolun sonuna noktalı virgül koyun. Windows 10 ve 11'de her yol ayrı satırda durur: "Yeni" ile satır ekleyip "Yukarı Taşı" ile en üste alabilirsiniz. Oracle'ın aynı işlem için hazırladığı anlatım: PATH sistem değişkenini ayarlama.
4. Değişikliğin geçerli olması için açık komut istemi pencerelerini kapatın, editörü yeniden başlatın ve java -version kontrolünü tekrarlayın.

UYAP Editör nasıl kullanılır?

Editör, bir kelime işlemci gibi çalışır; komutların çoğu Dosya, Düzenle, Ekle ve Araçlar menülerindedir. Aşağıdaki menü ve komut adlarını resmî yardım sayfasından aldık. O sayfa 2015 tarihli v4.0.14 sürümü için yazıldığından, güncel sürümde bazı etiketler küçük farklarla görünebilir. Satır aralığı, antet, sayfa numarası, tablo ve kısayolların ayrıntısı UYAP Editör kullanımı rehberinde.

Belge açma ve yeni belge

Dosya → Aç, bilgisayardaki .udf, .xml, .usf ve .rtf uzantılı evrakları açar. .docx bu listede yok; Word belgesini taşımak için Word'ü UDF'ye çevirme rehberindeki RTF yoluna bakın.

Dosya → Yeni boş bir belge açar. Resmî yardımda hazır dilekçe şablonlarından söz edilmiyor. Büronuzun kullandığı bir başlık düzeni varsa onu bir kez hazırlayıp .udf olarak saklayın ve her yeni dilekçeye bu dosyanın kopyasından başlayın; işin kolayı bu.

Tablo, resim, üst yazı ve sayfa numarası

Belge başka bir biçime aktarılırken en sık tablolar ve resimler bozulur. Dilekçede karmaşık bir tablo varsa kaydettikten sonra belgeyi kapatıp yeniden açın ve görünüme bir kez bakın.

Kaydetme ve başka biçime aktarma

Tek bir belge için Dosya → Farklı Kaydet'i kullanın, konumu seçip kaydedin. Resmî yardıma göre desteklenen biçimler .udf, .usf, .doc, .pdf, .odt, .rtf, .tif ve .jpg.

Elinizde çok sayıda UDF varsa Dosya → Tümünü Farklı Kaydet hepsini tek seferde çevirir. Evrakları ya da klasörü seçin, "Çıktı Klasörünü Seçin" ile hedefi belirleyin, biçimi (doc, odt, pdf, rtf) seçip "Kaydet"e basın.

PDF kopyası e-imzayı taşımaz; imzalı belgenin kendisi UDF olarak kalmalıdır. PDF'e çevirmenin diğer yolları ve dikkat edilecek noktalar UDF'yi PDF'e çevirme rehberinde.

Yazdırma

1. Dosya → Yazdır'ı açın.
2. Kopya sayısını girin ve yazıcıyı seçin.
3. Gerekiyorsa Sayfa Düzenleme sekmesinden ayarları değiştirin ve "Yazdır"a basın.

Pardus ve Debian tabanlı sistemlerde yazdırma çalışmıyorsa önce cups-bsd paketinin kurulu olduğunu kontrol edin.

E-imza ve mobil imza ile imzalama

Akıllı kart ya da USB token kullanıyorsanız:

1. E-imza kartınızı takın; kart okuyucunun sürücüsü kurulu olmalı.
2. Araçlar → İmza Kütüphanesi'nden kartınızın firmasını ya da kütüphanesini seçin.
3. "İmzala" simgesine basın, PIN'inizi girip "Tamam"a basın.
4. İmza başarılıysa editörün sağ üst köşesinde sertifika bilgilerini gösteren bir kurdele görünür.

Mobil imzada yol Araçlar → İmza → Dokümanı Mobil İmzala. GSM operatörünüzü, telefon numaranızı ve T.C. kimlik numaranızı girip "İmzala"ya basın. Ekranda görünen doğrulama kodunun telefonunuza gelen kodla aynı olduğunu kontrol ettikten sonra PIN'i telefonda girin.

İmzaladıktan sonra belgede değişiklik yaparsanız imzanın yeniden atılması gerekir. Haziran 2026'dan sonra imza atılamıyorsa sorun büyük olasılıkla güncellenmemiş yazılımdadır (aşağıda). İmzanın hukuki niteliği ve sık görülen hatalar için: UDF imzalama rehberi.

Yedekler ve kısayollar

Dosya → Yedekleri Aç, editörün aldığı yedekleri listeler. Beklenmedik bir kapanmadan sonra kaybolan belgeyi ilk burada arayın; yedek klasörünün yeri ve silinen ya da bozulan dosya için yollar UDF kurtarma rehberinde.

Menülere klavyeden Alt ya da F10 ile ulaşılır. Ctrl+F1 menüleri gizler, Ctrl + fare tekerleği yakınlaştırma oranını değiştirir. Sık kullandığınız komutlara kendi kısayolunuzu Araçlar → Kısayol Düzenle'den tanımlayabilirsiniz.

Haziran 2026: imza için güncelleme zorunlu

Adalet Bakanlığı Bilgi İşlem Genel Müdürlüğü'nün 31.05.2026 tarihli duyurusuna göre UYAP e-İmza (ArkSigner) uygulaması üzerinden sisteme giriş 1 Haziran 2026 itibarıyla sonlandırıldı. E-imzayla giriş artık e-Devlet Kapısı ya da Adalet e-İmza Uygulaması ile yapılıyor. Duyuru iki programın güncellenmesini istiyor: Adalet e-İmza Uygulaması ve UYAP Doküman Editörü. Güncellenmezlerse elektronik belgeler imzalanamıyor. Aynı duyuru uyap.gov.tr'de 11.06.2026 tarihiyle de yayımlandı.

Adalet e-İmza Uygulaması, kart okuyucu ya da USB token'daki sertifikayı tarayıcıya aktaran ve arka planda çalışan bir ara yazılımdır. İndirme adresi bedesten.adalet.gov.tr/imza. Büroda birden fazla bilgisayar varsa kontrolü her birinde ayrı yapın: biri güncellenmemişse imza yalnızca o makinede çalışmaz ve sorun kolayca kartta ya da token'da sanılabilir. İmzalama adımları UDF imzalama rehberinde.

Editörü güncelleme ve .uki klasörünü sıfırlama

Editörün kendi içinden güncelleme sunup sunmadığını doğrulayamadık. En güvenli yol, resmî sayfadaki son sürümü indirip kurmaktır. Editör açılmıyor, siyah bir pencere açılıp kapanıyor ya da imza atmıyorsa resmî sayfa şu üç adımı öneriyor:

1. Son sürümün kurulu olduğundan emin olun.
2. Tercih dosyalarını silin. Windows'ta C:\Users\<kullanıcı adınız>\.uki klasöründeki acilisdegerleri.xml ve tercihler.xml'i silip editörü yönetici olarak çalıştırın. Mac'te Finder'da Git → Ana Klasör altındaki gizli .uki klasöründe (gizli klasörleri görmek için Cmd+Shift+.) bu ikisine ek olarak lastOpened.xml'i silip editörü yeniden açın.
3. Sorun sürerse Denetim Masası'ndan "Uyap Kelime İşlemci"yi kaldırın, bilgisayarı yeniden başlatın, C:\Uyap klasörünü yedekleyip silin ve son sürümü kurun.

Üçüncü adımda resmî talimat C:\Uyap klasörünün silinmeden önce yedeklenmesini istiyor, bu yüzden yedeği atlamayın. Silinen tercih dosyaları, adlarından anlaşıldığı gibi açılış ayarları ve tercihlerdir, belgeleriniz değildir. Resmî yardım sayfasına göre editörün aldığı yedekler de .udf uzantılıdır ve Dosya menüsündeki "Yedekleri Aç" ile açılır.

Resmî olmayan paketler ve indirme siteleri

Editörü yalnızca uyap.gov.tr'den indirin. Forumlarda ve yazılım indirme sitelerinde editörün yeniden paketlenmiş kopyaları, GitHub'da da bağımsız geliştiricilerin hazırladığı gayriresmî paketler dolaşıyor. Bunların bir kısmı PowerShell'de tek satırlık bir komutla (irm … | iex) kurulmayı öneriyor; bu komut internetten indirilen bir betiği incelemeden doğrudan çalıştırır. Söz konusu paketler Adalet Bakanlığı ile ilişkili değil ve depolardan biri bunu kendisi de açıkça yazıyor.

Bizce asıl risk, e-imzanın ve mahkeme evrakının aynı bilgisayarda bulunması. Kurulum dosyasını değiştirebilen biri, imza atılan makineye erişmiş olur. Mağazalarda resmî adı andıran mobil uygulamalar için de aynı dikkat gerekir: yayıncının T.C. Adalet Bakanlığı olup olmadığına bakın.