# İnternet erişimi olmadan kurulum

> Merkez sunucuyu ve Edge Gateway'leri internete kapalı bir ağa kurun. İmajları dosyayla taşıyın, yükleyin, başlatın ve lisansı çevrim dışı etkinleştirin.

Kaynak: https://proxus.io/tr/docs/operate/offline-install

Bu kılavuzu tamamladığınızda Proxus merkez sunucusu internete erişemeyen bir makinede çalışır, lisansı etkin olur ve
aynı kapalı ağdaki Edge Gateway'ler kurulabilir. Dosyaları internet erişimi olan bir makinede hazırlar, örneğin bir
USB bellekle taşırsınız.

Proxus ağınızın içinde veri toplamak, saklamak, göstermek ve aktarmak için internet bağlantısına ihtiyaç duymaz.
Normalde internetten gelen iki şey vardır ve bu sayfa ikisinin de yerini tutar: kurulum betiği (`proxus.io`
adresinden) ve konteyner imajları (Docker Hub'dan).

## Başlamadan önce

Şunlar hazır olmalı:

- Dosyaları indirmek için Docker kurulu, **internete bağlı bir makine**. Hedef makinelerle aynı işlemci türünde
  olmalı (x86-64 ya da ARM64). Değilse her `docker pull` komutuna `--platform` ekleyin, örneğin
  `--platform linux/arm64`.
- Kapalı ağda, Docker Engine ve Docker Compose eklentisi önceden kurulmuş ve
  [sistem gereksinimlerini](https://proxus.io/tr/docs/get-started/system-requirements) karşılayan **merkez sunucu makinesi**. Docker
  Proxus dosyalarına dahil değildir. Önce işletim sisteminizin çevrim dışı paketlerinden kurun.
- Merkez sunucu makinesine yaklaşık 2-3 GB dosya taşıyabileceğiniz bir yol.
- Bir lisans anahtarı ya da merkez sunucunun **Lisans kimliği** değerini başka bir makineden Proxus'a veya
  distribütörünüze gönderebileceğiniz bir yol ([Adım 5](#adım-5-lisansı-etkinleştirin) bölümüne bakın).

## Adım 1: Dosyaları internete bağlı makinede indirin

1. Merkez sunucu makinesinin işletim sistemine uygun kurulum betiğini indirin:

         ```bash
   curl -fsSL https://proxus.io/install.sh -o install.sh
   ```
         ```powershell
   Invoke-WebRequest https://proxus.io/install.ps1 -OutFile install.ps1
   ```
      
   Proxus teslimatınızla hazır bir `docker-compose.yml` geldiyse kurulum betiği yerine o dosyayı da
   kullanabilirsiniz.
2. Merkez sunucunun kullandığı imajları indirin:

   ```bash
   docker pull proxusplatform/proxus-ui:latest
   docker pull proxusplatform/proxus-server:latest
   docker pull nats:alpine
   docker pull postgres:16
   docker pull bitnamilegacy/clickhouse:latest
   ```

   Bunlar, kurulum betiğinin yazdığı compose dosyasındaki imajlardır. Teslimatınızla gelen bir compose dosyası
   kullanıyorsanız, dosyanın klasöründe `docker compose config --images` komutu gereken imajları listeler.
3. İmajları tek bir dosyaya kaydedin:

   ```bash
   docker save -o proxus-hub-images.tar \
     proxusplatform/proxus-ui:latest proxusplatform/proxus-server:latest \
     nats:alpine postgres:16 bitnamilegacy/clickhouse:latest
   ```
4. Kapalı ağdaki başka makinelere Edge Gateway kuracaksanız onların imajlarını da kaydedin. Edge Gateway aynı
   `proxus-server` imajını, kendine ait küçük bir mesaj sunucusuyla birlikte çalıştırır:

   ```bash
   docker pull nats:2-alpine
   docker save -o proxus-edge-images.tar proxusplatform/proxus-server:latest nats:2-alpine
   ```

`install.sh` (ya da `install.ps1` veya `docker-compose.yml`) dosyasını ve `.tar` dosyalarını taşınabilir belleğe
kopyalayın.

## Adım 2: İmajları merkez sunucu makinesine yükleyin

Dosyaları merkez sunucu makinesine kopyalayın, ardından imajları yükleyin:

```bash
docker load -i proxus-hub-images.tar
docker image ls
```

`docker image ls` beş imajı yukarıdaki etiketleriyle listeler. Docker Compose makinede zaten bulunan imajı kullanır
ve hiçbir şey indirmez.

## Adım 3: Merkez sunucuyu başlatın

Taşıdığınız kurulum betiğini, Proxus'un kurulacağı klasörde çalıştırın:

```bash
bash install.sh
```
```powershell
powershell -ExecutionPolicy Bypass -File .\install.ps1
```

Kurulum betiği internet erişimi gerektirmez. Bölge ayarını ve saat dilimini sorar, Edge Gateway'lerin kullanacağı
makine adresini bulur ve `proxus-platform/docker-compose.yml` dosyasını yazar. **Start the platform now?** sorusuna
`Y` yanıtını verin: yığın yüklenen imajlarla başlar.

Teslimatınızla gelen bir compose dosyası kullanıyorsanız
[Compose dosyasından kurun](https://proxus.io/tr/docs/get-started/install#compose-dosyasından-kurun) bölümündeki adımları izleyin.
Oradaki `docker compose up -d` komutu da yüklenen imajları kullanır.

Bütün servislerin çalıştığını ve durumlarının `healthy` olduğunu kontrol edin:

```bash
cd proxus-platform
docker compose ps
```

## Adım 4: Merkez sunucuya internet erişimi olmadığını bildirin

Edge Gateway kurulum penceresi, merkez sunucunun internetteki genel adresini de önerir. Merkez sunucu bu adresi
internete sorarak bulur. Kapalı ağda bu sorgu sonuç vermez ve listede yalnızca yerel adresler görünür. Sorguyu
tamamen kapatmak için `docker-compose.yml` dosyasında `proxus-ui` servisinin `environment:` bölümüne şu satırı
ekleyin ve `docker compose up -d` komutunu çalıştırın:

```yaml
      Service__DetectPublicAddress: "false"
```

## Adım 5: Lisansı etkinleştirin

Lisans, merkez sunucuda anahtarın dijital imzasıyla doğrulanır. Etkinleştirme sırasında Proxus'a bağlanılmaz. Bu
yüzden kapalı ağda da aynı şekilde çalışır.

1. `https://<host>:8443` adresini açın ve [İlk kez oturum açın](https://proxus.io/tr/docs/get-started/install#ilk-kez-oturum-açın)
   bölümündeki gibi `Admin` kullanıcısıyla, parolayı boş bırakarak oturum açın.
2. **Lisans etkinleştirme** penceresinde **Lisans kimliği** değerinin yanındaki **Kopyala** düğmesine tıklayın ve
   değeri not edin ya da bir dosyaya kaydedin.
3. E-posta ya da internet erişimi olan herhangi bir makineden Lisans kimliğini Proxus'a veya distribütörünüze
   gönderin. Size gönderilen anahtar yalnızca bu kimlikle çalışır.
4. Anahtarı **Lisans anahtarı** alanına yapıştırın, sözleşmeyi kabul edin ve **Lisansı etkinleştir** düğmesine
   tıklayın.

Lisans kimliği, merkez sunucunun çalıştığı makineden ve yapılandırma biriminden türetilir. Merkez sunucuyu taşırken
ya da geri yüklerken ikisini de koruyun, aksi hâlde yeni bir anahtar isteyin. Bkz. [Lisans](https://proxus.io/tr/docs/administer/license).

## Kapalı ağa Edge Gateway kurun

Edge Gateway'in yalnızca merkez sunucuya erişmesi gerekir: `7422` portuna ve merkez sunucunun HTTPS portuna
(varsayılan `8443`).

1. Edge Gateway makinesinde, Adım 1'de kaydettiğiniz imajları yükleyin:

   ```bash
   docker load -i proxus-edge-images.tar
   ```
2. Edge Gateway'i merkez sunucuda oluşturun ve kurulum komutunu
   [Edge Gateway kurun](https://proxus.io/tr/docs/connect/edge-gateways/install-a-gateway) sayfasındaki gibi çalıştırın. Komut
   merkez sunucudan geldiği için internet erişimi gerekmez. İmaj indirilemezse kurulum betiği makinede zaten bulunan
   imajları kullanır ve devam eder.

Edge Gateway imajını kendi ağınızdaki bir imaj deposundan almak isterseniz, `proxus-ui` servisinde
`EdgeDeployment__Image` değerini imajın o depodaki tam adına ayarlayın, örneğin
`registry.plant.local/proxusplatform/proxus-server:latest`. Kurulum komutu bundan sonra bu adı kullanır.

## Neler internet gerektirir, yerine ne kullanılır

| Özellik | İnternet erişimi olmadan |
| --- | --- |
| Kurulum, yükseltme | İmajları bu sayfadaki gibi taşıyın. |
| Lisans | Çalışır. Yalnızca Lisans kimliği ve anahtar, seçtiğiniz herhangi bir kanalla gidip gelir. |
| Copilot | Ağınızdaki bir makinede **Ollama (yerel)** kullanın. Bulut yapay zekâ hizmetlerine erişilemez. Copilot'un doküman araması merkez sunucuyla birlikte gelir ve çevrim dışı çalışır. Bkz. [Copilot ayarları](https://proxus.io/tr/docs/administer/copilot-settings). |
| Veri hedefleri | Ağınızdaki bir hedef çalışır. Bulut hedefi, ona veri gönderen Edge Gateway hedefe erişebiliyorsa çalışır. AWS IoT Core için Amazon Root CA 1 dosyasını sertifikalarla birlikte seçin: merkez sunucu bu dosyayı kendisi indiremez. Bkz. [Veri hedeflerine güvenli bağlantı](https://proxus.io/tr/docs/connect/secure-target-connections). |
| Bildirim kanalları | E-posta, ağınızdaki bir posta sunucusuyla çalışır. Slack, Teams ya da Telegram gibi internetteki hizmetlere erişilemez. |
| Dokümantasyon | Bu site internet gerektirir. Merkez sunucudaki doküman kopyası (Copilot'un kullandığı) gerektirmez. |

## İnternet erişimi olmadan yükseltme

Yeni sürüm için Adım 1'i internete bağlı makinede tekrarlayın, ardından merkez sunucu makinesinde:

```bash
docker load -i proxus-hub-images.tar
cd proxus-platform
docker compose up -d
```

Yükleme `latest` imajlarının yerini alır ve Compose yalnızca imajı değişen konteynerleri yeniden oluşturur. Önce
[Yükseltme](https://proxus.io/tr/docs/operate/upgrade) sayfasını okuyun: neyin yedekleneceğini ve her sürümden sonra ne yapılacağını
anlatır.

Her Edge Gateway makinesinde yeni imajları yükleyin ve Edge Gateway'i kendi klasöründe yeniden oluşturun.
[Edge Gateway'leri yükseltin](https://proxus.io/tr/docs/operate/upgrade#edge-gatewayleri-yükseltin) bölümündeki `pull` adımını
atlayın:

```bash
docker load -i proxus-edge-images.tar
cd /opt/proxus/proxus-edge-3
sudo docker compose -p proxus-edge-3 -f compose.yaml up -d
```

## Sonraki adımlar

- Tesis ağını bağlamadan önce [kurulumu sağlamlaştırın](https://proxus.io/tr/docs/operate/security).
- `config` birimi dahil [kurulumu yedekleyin](https://proxus.io/tr/docs/operate/backup-and-restore).
- Günlük komutlar için [Proxus'u Docker ile çalıştırın](https://proxus.io/tr/docs/operate/docker).