Sistem Gereksinimleri

Mikromax ERP, Docker container teknolojisi üzerinde çalışmaktadır. Kurulum ve işletim için aşağıdaki gereksinimlerin karşılanması gerekmektedir.

Donanım Gereksinimleri

Konfigürasyon İşlemci RAM Disk
Minimum 2 Çekirdek 4 GB 60 GB
Optimum 4 Çekirdek 8 GB 60 GB

Not: Disk alanı için SSD kullanılması sistem performansını önemli ölçüde artırmaktadır.

İşletim Sistemi

Mikromax olarak Ubuntu 24.04 LTS sürümü önerilmektedir.

  • Sunucunun internet erişiminin bulunması gerekmektedir (Docker imajlarının indirilmesi için).
  • Sisteme root veya sudo yetkili bir kullanıcı ile erişim sağlanabilmelidir.

Docker Kurulumu

Sistemde Docker Engine ve aşağıdaki eklentilerin kurulu olması gerekmektedir:

  • docker-ce
  • docker-ce-cli
  • containerd.io
  • docker-buildx-plugin
  • docker-compose-plugin

Ubuntu üzerine Docker kurulumu için resmi Docker belgelerini takip ediniz: https://docs.docker.com/engine/install/ubuntu/

Kurulum Sonrası Kontrol

Docker’ın doğru kurulduğunu doğrulamak için aşağıdaki komutları çalıştırınız:

docker --version
docker compose version

Her iki komutun da sürüm bilgisi döndürmesi gerekmektedir.

Alan Adı (DNS) Gereksinimleri

Sistem dışarıya Nginx üzerinden açılmaktadır. Her servis için ayrı bir alt alan adı (subdomain) kullanılmaktadır. Aşağıdaki tüm alt alan adlarının, sunucunuzun genel IP adresine (public IP) yönlendirilmiş olması gerekmektedir.

İsteğe bağlı olarak alan adlarını kendi domain sunucunuzda ayarlayabilirsiniz. Bu durumda domain DNS kayıtlarını kurmuş olacağınız ubuntu sunucuya yönlendirmeniz gerekmektedir.

Aşağıdaki servislerden size uygun olanlar için alan adı oluşturmanız gerekmektedir.

Servis Alt Alan Adı (Örnek) Açıklama
Kimlik Doğrulama identity.yourdomain.com Kullanıcı girişi ve yetkilendirme
Ana API api.yourdomain.com REST API servisi
Web Arayüzü web.yourdomain.com Kullanıcı arayüzü
Yazdırma printing.yourdomain.com Yazdırma servisi
BPM bpm.yourdomain.com İş Süreci Yönetimi
Bildirimler notificator.yourdomain.com Bildirim servisi
Raporlama reporting.yourdomain.com Raporlama servisi
ERP Eklentileri ext.yourdomain.com ERP eklenti servisi
Log Arayüzü (opsiyonel) seq.yourdomain.com Yalnızca yetkili personel için
RabbitMQ (opsiyonel) rabbitmq.yourdomain.com Yalnızca yetkili personel için

Not: yourdomain.com yerine kurumunuzun gerçek alan adını kullanınız. DNS kayıtları genellikle alan adı sağlayıcınızın yönetim panelinden A kaydı olarak eklenir ve IP olarak sunucunuzun genel IP adresi girilir.

Not: DNS değişikliklerinin etkili olması birkaç dakika ile 48 saat arasında sürebilir.

SSL Sertifikası Gereksinimleri

Tüm servisler HTTPS üzerinden sunulmaktadır. Kuruluma başlamadan önce geçerli bir SSL sertifikasının temin edilmiş olması gerekmektedir.

Sertifika aşağıdaki iki biçimde olabilir:

  • Wildcard sertifika (*.yourdomain.com) — tüm alt alan adlarını tek sertifika ile karşılar; önerilir.
  • Servis başına tekil sertifika — her alt alan adı için ayrı sertifika temin edilir.

Sertifika Dosyalarının Yerleştirilmesi

Sertifika dosyaları sunucuda aşağıdaki konuma kopyalanmalıdır:

/etc/mikromax/nginx/certs/cert.crt   ← Sertifika dosyası
/etc/mikromax/nginx/certs/key.key    ← Özel anahtar dosyası

Not: Dosya adları farklıysa Nginx konfigürasyon dosyalarındaki ssl_certificate ve ssl_certificate_key satırları buna göre güncellenmelidir.