Eksen Bilişim
WhatsApp destek
Eksen Bilişim partner kurulum kılavuzu

Aura
partner kurulumu.

Eksen Bilişim'den Raspberry Pi + SD kart ulaştı. Müşteri sahasında 3 adım, ~10 dk: aç → SSH → tek komut. Donanımı Eksen Bilişim tedarik eder, kurulumu siz yapar, müşteriye teslim edersiniz.

Tek komut:curl -sSL https://eksenbilisim.com/aura/install.sh | bash
Partner paketi içeriği

Sizden gelen kutuda neler var?

  • Raspberry Pi 4B (4 GB)
  • Önceden hazırlanmış SD kart
  • USB-C 3A adapter
  • Müşteri kullanım kartı (QR + WhatsApp)

Pi Imager + image yazma süreciyle uğraşmanıza gerek yok. Müşteri Wi-Fi'sini sahada SD'ye yazacaksanız aşağıdaki "Kendi donanımım" bölümüne bakın.

01
Pi’yi aç
3 dk
02
SSH
1 dk
03
install.sh
5-7 dk
04
Müşteri teslim
2 dk
✦ Adımlardan önce

Laptop hazırlığı.

SSH + mDNS desteği işletim sistemine göre değişiyor. macOS'ta sıfır kurulum, Windows'ta 2 küçük adım yeter. Docker laptop'ta gerekmez— Pi'de çalışıyor.

macOS

Hazır

SSH ve Bonjour built-in. Terminal aç, direkt başla.

ssh aura@aura.local

Windows 10/11

2 adım
  1. 1 · OpenSSH client (genelde dahil)

    PowerShell aç, kontrol et:

    Get-WindowsCapability -Online | ? Name -like "OpenSSH.Client*"

    "State: Installed" gözükmüyorsa: Ayarlar → Uygulamalar → İsteğe Bağlı Özellikler → OpenSSH Client ekle.

  2. 2 · Bonjour for Windows (mDNS)

    aura.local adresini çözmek için. Apple, ücretsiz, ~1 MB.

    Bonjour Print Services indir
Bonjour kurulmuyor / yüklenmiyor?Müşteri router'ına gir (genelde 192.168.1.1), DHCP listesinde "aura" hostname'ini bul, IP'si ile bağlan: ssh aura@192.168.1.X
Adım 01 · 3 dk

Pi'yi müşteri Wi-Fi'sine bağla, güç ver

Eksen Bilişim’den gelen kutudan Pi 4B + SD kart + adapter. Müşteri evindesin, Wi-Fi parolasını al.

  • SD kartı Pi 4B yuvasına tak (zaten yazılı, Wi-Fi/SSH/locale ayarlanmış)
  • USB-C 3A adapter’i Pi’ye + prize tak — güç ver
  • Yeşil LED yanıp sönmeye başlar → boot ediyor
  • 2-3 dk bekle: Pi müşteri Wi-Fi’sine bağlanır, DHCP’den IP alır, mDNS yayını başlatır
Wi-Fi parolasını önceden öğren.Eksen Bilişim'e müşteri Wi-Fi bilgisini önceden bildirirsen, SD kart sizin için zaten konfigüre edilir. Aksi durumda Kendi donanımım bölümüne bak — sahada nasıl Wi-Fi yazılır.
Adım 02 · 1 dk

SSH ile Pi'ye bağlan

Mac veya Windows laptop'tan, müşteri Wi-Fi'sindeyken.

ssh aura@aura.local

İlk seferde fingerprint sorusu:

Are you sure you want to continue connecting? yes

Eksen Bilişim'in size verdiği parolayı gir. Pi prompt'una düşersin:

aura@aura:~ $
aura.local çözmüyorsa?Müşterinin router admin arayüzüne gir (genelde 192.168.1.1), DHCP listesinde "aura" hostname'ini bul, ssh aura@<ip>. Mesh Wi-Fi (Eero, Google Wifi) bazen mDNS'i geçirmez — Pi'yi router'a Ethernet ile bağla.
Adım 03 · 5-7 dk

Tek komutla Aura kurulumu

Bir satır. Geriye yaslan — sahada konfigürasyon yok.

curl -sSL https://eksenbilisim.com/aura/install.sh | bash

Script otomatik yapar:

AdımSüre
apt update + Docker + avahi + qrencode~2 dk
"Cihaza isim ver" interaktif soru5 sn
Aura stack indir (25 MB)~30 sn
docker compose up + HA image (~600 MB)3-5 dk
HA sağlık kontrolü (60×3 sn timeout)30-60 sn
QR kod + URL çıktısı—

Sonunda ekrana basılan:

╭──────────────────────────────────────────╮
│  ✅ AURA HAZIR                           │
╰──────────────────────────────────────────╯

  📡 Yerel ağ:  http://aura.local:8123
  🌐 IP:       http://192.168.1.X:8123

  📱 [QR KOD — telefonla tara]

  📲 Mobil uygulama:  App Store / Google Play → "Aura"
  📖 Kullanım rehberi: https://eksenbilisim.com/aura/yardim
  💬 WhatsApp destek:  +90 536 921 23 65
Fleet kurulumu için müdahalesiz mode: Hostname’i environment’tan ver, prompt sorma:
curl -sSL https://eksenbilisim.com/aura/install.sh | \
  AURA_HOSTNAME=aura-villa-bodrum bash
Adım 04 · 2 dk

Müşteriye teslim — onboarding + mobil

install.sh ekrana QR + URL bastı. Şimdi müşteriye sizin değil, kendisinin yönettiği bir Aura teslim ediyorsunuz.

Müşteriyle birlikte yapın
  • Müşteri kullanım kartındaki QR’ı telefonla tarat → tarayıcıda Aura onboarding açılır
  • "Akıllı evimi yarat" turuncu butona müşteri bassın
  • Admin hesabı ad/e-posta/parolayı MÜŞTERİ yazsın (siz arkanızı dönün, bilmeyin)
  • Konum: İstanbul (Aura otomatik bulur), birim sistemi: metrik
  • Aura dashboard açılınca: Profil → Tema → "aura" seçin (turuncu vurgular aktive olur)
Mobil app — müşterinin telefonuna
  • App Store / Play Store → "Home Assistant" indir (Aura Companion Faz 3’te çıkacak)
  • İlk açılışta "Manual connection" → http://aura.local:8123
  • Müşteri kendi admin hesabıyla giriş
  • Push bildirim izni ver (alarm/uyarı için kritik)
KVKK / parti sınırı:Müşteri verisi müşterinindir. Admin parolasını kaydetmeyin. Sahada şart oluyorsa, müşteri sonradan "Aile üyesi davet" ile geçici teknisyen hesabı açıp size verebilir — destek bitince siler.
Müşteriye söyleyin: Kullanım kartındaki WhatsApp +90 536 921 23 65 numarası 7/24 açıktır. Sorun çıkarsa direkt yazabilirler — sizi geri çağırmadan %80'i çözülür. Yazılı kullanım kılavuzu: eksenbilisim.com/aura/yardim.
✦ Opsiyonel

Kendi donanımım var.

Eksen Bilişim'den kit beklemek istemiyorsan veya stoğunda Pi varsa, SD kartı kendin imajla. Aşağıdaki adımlar Pi Imager süreciyle saha öncesi SD'yi hazırlar.

Pi Imager ile SD kart hazırlığı

Pi Imager → indir, kur, çalıştır.

Pi Imager'da seç
  • CHOOSE DEVICE → Raspberry Pi 4
  • CHOOSE OS → Raspberry Pi OS (other) → Raspberry Pi OS Lite (64-bit)
  • CHOOSE STORAGE → SD kartı seç
  • NEXT → Edit Settings
General sekmesi
  • Hostname: aura (veya müşteriye özel: aura-villa-bodrum)
  • Username: aura
  • Password: parola yöneticisinden üret (tahmin edilemez)
  • Wi-Fi: müşteri evi SSID + parola
  • Wi-Fi country: TR
  • Locale: tr_TR.UTF-8, Europe/Istanbul
Services sekmesi
  • SSH etkin (Use password authentication)

SAVE → WRITE. Yazma ~4-5 dk sürer.

Neden Pi OS Lite, Desktop değil? Headless server için ekran/klavye yok, GUI gereksiz. 16 GB SD kartta chromium + GUI ~1 GB yer + RAM tüketir.
Sonra: SD'yi Pi'ye tak → güç ver → yukarıdaki Adım 02 (SSH) ile devam et. Imager'da girdiğin password Adım 02'de istenen paroladır.
✦ Saha tekniker çantası

Yanında ne olmalı?

Önceden hazırlanmış SD kart + Pi 4B

Müşteri sahasında Pi Imager indirme + image yazma derdi olmasın. Kurulum süresi yarıya iner.

Mac/Windows laptop

Müşteri Wi-Fi SSID + parolasını Pi'ye yazmak için. SSH'tan bağlanıp install.sh tetiklemek için.

USB-C 3A adapter

Pi 4B nominal ~3A çeker. Düşük amperajlı adapter Aura kapanmasına / instabiliteye yol açar.

Yedek SD kart (16-32 GB)

SD kart bozulduğunda saha müdahaleyi geciktirmemek için. Bozuk SD’yi geri al, yedeği imajla, geç.

Bu rehberin PDF çıktısı

Müşteriye veriyorsun → ileride teknisyen geri çağırmadan kendi bakar. WhatsApp QR + URL bilgisi yazılı dursun.

Müşteri Wi-Fi’sini önceden öğren

SSID + parola önceden bilinirse Pi Imager’a yazılır, Pi açılır açılmaz internet bağlanır. Saha zamanı %30 azalır.

✦ Sorun giderme

En sık karşılaşılanlar.

ssh aura@aura.local — "ssh: Could not resolve hostname"

mDNS broadcasti yapılmıyor. Sebepler: (1) Pi henüz açılmamış (2-3 dk bekle), (2) Mesh Wi-Fi multicast’i bloke ediyor (Eero/Google Wifi), (3) Pi farklı VLAN’da. Çözüm: router admin arayüzünden Pi’nin IP’sini bul, ssh aura@<ip>.

install.sh — "Permission denied" veya "Docker not running"

Script root değil normal kullanıcı olarak çalışıyor. Eğer "newgrp docker" hatası alırsa script otomatik sudo ile devam eder. Sorun sürerse: çıkış yap, tekrar SSH gir (Docker grup üyeliği yeni session’da aktive olur).

docker compose up — image pull çok yavaş

HA image 600 MB. Müşteri internet bağlantısı yavaşsa 10-15 dk sürebilir. Sahaya gitmeden önce stack’i önceden indirmek için tarball’u USB ile götürebilirsin (offline kurulum scripti Faz 2 devamı).

Tarayıcıda http://aura.local:8123 — "site reached but refused"

HA henüz boot olmamış. install.sh sağlık check ile bekler, ama erken tarayıcı denersen "refused" alırsın. install.sh’ın "✅ AURA HAZIR" ekranını bekle.

Aura tema "aura" listede yok

configuration.yaml içinde frontend.themes blok’u yüklenmemiş. SSH ile gir → cd ~/aura → docker compose restart homeassistant. HA tema dosyalarını yeniden okur.

Mobil app: "aura.local" çözmüyor (Android)

Bazı Android sürümlerinde mDNS desteği app-spesifik. HA Companion mDNS bilir, ama tarayıcıdan giriş yaparken IP gerekebilir. Router’dan IP bul, http://<ip>:8123 yaz.

✦ Takıldıysan

Saha destek hattı 7/24.

WhatsApp
+90 536 921 23 65
Saha sırasında, anında yanıt
Kullanıcı yardımı
/aura/yardim
Müşterilere yönlendir