Destek & sorun giderme

Satın almadan sonra lisans anahtarın ve indirme linkin birkaç dakika içinde e-posta ile gelir (gönderen: noreply@themyway.app).

Görmüyorsan önce spam / gereksiz ve “Tanıtımlar” klasörlerine bak ve birkaç dakika bekle. Checkout’ta doğru e-postayı girdiğinden emin ol. Mail o adrese gider.

Hâlâ ulaşmadıysa, Paddle sipariş e-postanla bize yaz; anahtarını ve indirme linkini elle gönderelim.

İndirme linki lisans anahtarınla korunur; her zaman en son gelen e-postadaki linki kullan.

Link hata veriyorsa (geçersiz imza, güncelleme hakkının sona ermesi), lisans anahtarınla bize yaz, yeni bir link üretelim.

./scripts/update.sh "Download failed" diyorsa sebep lisans anahtarı, ağ ya da güncelleme hakkının sona ermesi olabilir; betik sunucunun açıklamasını göstermez. Nedeni görmek için uygulamada Ayarlar > Güncellemeler’e bak ya da bize yaz.

Sunucunda Docker ve Docker Compose kurulu olmalı. Paketi aç, cd myway-onprem, ardından ./scripts/install.sh çalıştır.

İmajlar docker load ile yüklenir. Ayrıca build gerekmez. Kurulum bitince tarayıcıdan kaydolan ilk kullanıcı otomatik süper yönetici (superadmin) olur.

install.sh kurulum sırasında lisans anahtarını sorar ve .env.onprem dosyasına yazar.

Geçerli anahtar yoksa uygulama kilitli açılır; anahtarı .env.onprem dosyasına yazıp docker compose -f docker-compose.onprem.yml --env-file .env.onprem up -d çalıştırınca açılır. Yalnız restart env dosyasını yeniden okumaz.

Uygulamayı çalıştırmak için geçerli lisans gerekir. Süre dolunca kısa bir ek süre (grace) çalışır, sonra kilitlenir.

Verin sunucunda güvende kalır; lisansı yenileyince kaldığın yerden devam edersin. Yıllık lisans kendiliğinden yenilenmez; yeni anahtar için bize yaz. Yeni anahtarı .env.onprem içindeki LICENSE_KEY satırına yaz ve docker compose -f docker-compose.onprem.yml --env-file .env.onprem up -d çalıştır; restart env dosyasını yeniden okumaz.

v1.67.2 ve sonrasında kurulum dizininde ./scripts/update.sh çalıştır: en son paketi lisans anahtarınla indirir, imzasını doğrular, önce yedek alır, sonra günceller; imzası doğrulanamayan paket kurulmaz. Yeni sürüm açılmazsa betik önceki sürüme kendiliğinden döner. Kurulumda ./scripts/install.sh --auto-update ile açtıysan süper yönetici güncellemeyi Ayarlar > Güncellemeler’den hemen kurabilir ya da ileri bir saate planlayabilir. Sunucunun internet erişimi yoksa paketi başka bir bilgisayarda indir (Ayarlar > Güncellemeler > "İnternet erişimi olmayan sunucu"), sunucuya kopyala ve ./scripts/update.sh --package <dosya> --check, sonra --check olmadan çalıştır (v1.110.0). Kurulu betik --package’ı tanımıyorsa bir kez MYWAY_DOWNLOAD_URL="file:///tam/yol/myway-onprem.tar.gz" ./scripts/update.sh çalıştır. scripts/update.sh hiç yoksa (v1.67.2 öncesi) paketi mevcut kurulum dizininin üstüne açıp ./scripts/install.sh çalıştır, yeni bir dizine asla. Yedekleme ve yükseltme adımlarının ayrıntısı kılavuzda.

./scripts/update.sh "The package signature or its contents do not match" diyorsa indirilen dosya bozulmuş ya da değiştirilmiş olabilir; yeniden dene, tekrarlarsa bize yaz. "The package is not signed" MyWay paketlerinde olmaz; --allow-unsigned yalnız kendi ürettiğin paket içindir. "Cannot verify the signature on this server" sunucuda OpenSSL 3 olmadığını ve kurulu uygulama imajının bulunamadığını söyler: OpenSSL 3 kur ya da paketi elle güncelle. "The package carries a different signing key" paketin getirdiği anahtarın kurulumun güvendiği anahtarla aynı olmadığını söyler; paket kurulmaz, yeniden indir, tekrarlarsa bize yaz. "... which is OLDER than the installed ..." eski bir paket verildiğini söyler; en yeni paketi kullan.

Ajan sunucuda cron ile dakikada bir çalışır; 5 dakikadır yoklama yoksa bu uyarı çıkar. Sunucunun cron servisini ve kurulum dizinindeki logs/update-agent.log dosyasını kontrol et, gerekirse ./scripts/install.sh --auto-update ile yeniden kur. Kurulum NO_CRON=1 ile yapıldıysa ajan hiç kurulmamıştır.

Ekran "Güncelleme ajanı kurulu ama sunucuda çalışamıyor" diyorsa ve kurulum macOS’ta İndirilenler, Masaüstü, Belgeler ya da iCloud Drive altındaysa cron bu klasörü okuyamaz ("Operation not permitted"). Cron’a Tam Disk Erişimi ver (Sistem Ayarları > Gizlilik ve Güvenlik > Tam Disk Erişimi > + ile /usr/sbin/cron) ya da kurulumu ~/myway-onprem gibi bir klasöre taşıyıp ./scripts/install.sh’ı orada yeniden çalıştır; veri Docker birimlerinde durduğu için kaybolmaz. Durumu ./scripts/macos-cron-check.sh ile denetle, sorun yoksa hiçbir şey yazmaz. v1.103.0 öncesinde ajan macOS’ta kabuk uyumsuzluğu yüzünden de çalışmıyordu; o sürüme bir kez ./scripts/update.sh ile elle geç.

Yeni sürüm açılmadığı için kurulum önceki sürüme döndü ve .env.onprem içine IMAGE_TAG=<önceki sürüm> yazdı; yeniden başlatma yeni sürümü açmasın diye satır bilerek kalır. Sebebi logs/update-<istek>.log ya da docker compose -f docker-compose.onprem.yml logs app gösterir. Sorunu giderince IMAGE_TAG satırını sil ve ./scripts/update.sh’i yeniden çalıştır; satır dururken betik başlamaz. Çözemezsen destek paketiyle bize yaz.

Dosya boyutu, toplu işlemde seçilebilen görev sayısı, içe aktarmada alınan satır, maddeleriyle kopyalama ve dakikalık yazma sınırları Ayarlar > Sistem sınırları’ndan süper yönetici tarafından değiştirilir (v1.87.0). Kendi ters vekilin varsa onun istek gövdesi sınırını da yükselt. v1.110.0’dan beri sınırı aşan dosya seçildiği anda dosya adı ve sınırla uyarı verir, gönderilmez. Ürünle gelen ters vekil de v1.109.1’den beri büyük istekleri uygulamaya ulaşmadan keser; Caddy imajını docker compose -f docker-compose.onprem.yml pull caddy ile güncel tut.

https://<adresin>/api/health çıktısında mailConfigured false ise ayar uygulamaya ulaşmıyor. .env.onprem içinde MAIL_DRIVER=smtp, MAIL_SMTP_HOST ve MAIL_FROM dolu olmalı; sonra up -d çalıştır (restart env okumaz). Parolada $ varsa $$ yaz. Ayar ulaşıyorsa Ayarlar > Sağlık > Uygulama günlüğünde türü "Dış servis" ya da "Yapılandırma" olan kayda tıkla; e-postanın neden reddedildiği (ör. kimlik bilgisi) orada yazar. Bildirim e-postaları kuyruktan gider ve beş kez denenir; Ayarlar > Sağlık’taki E-posta satırı kuyrukta bekleyen ya da gönderilemeyen e-postayı gösterir.

Zamanlanmış işleri kurulum betiği kurar; güncellemede de betiği çalıştır. Ayarlar > Sağlık ekranı her işin en son ne zaman çalıştığını gösterir, çıktısı kurulum dizinindeki logs/cron.log dosyasındadır. Görev, iş akışında "Son tarih takibi bu statüde durur" işaretli bir statüdeyse bildirim bilerek gönderilmez.

v1.76.0 öncesinde içe aktarma penceresinde bir .xlsx dosyası seçmek hiçbir şey yapmıyordu; CSV dosyası çalışıyordu. v1.76.0’a güncelle ya da o zamana kadar dosyayı CSV olarak kaydedip yükle. Güncel sürümde okunamayan bir dosyada "Dosya okunamadı. Geçerli bir .xlsx ya da .csv dosyası seçin." uyarısı çıkar.

Beklenmeyen bir sunucu hatasında mesajın sonunda bir başvuru kodu görünür, örneğin (Başvuru kodu: 7f3a9c2b1e04). Superadmin bu kodu Ayarlar > Sağlık’taki Uygulama günlüğü kartının arama kutusuna yapıştırarak o isteğin kaydını ayrıntısıyla bulur.

Bize yazarken kodu ve bir destek paketi ekle. Paketi sunucuda kurulum dizininde ./scripts/support-bundle.sh oluşturur, uygulama açılmıyorken de çalışır; uygulama açıksa Ayarlar > Sağlık’taki “Destek paketi indir” düğmesi de kullanılabilir. Parola ve anahtar değerleri pakete girmez.