Güncelleme, Geri Alma ve Sıfırlama

Bu komutlar IronFlockOS çalıştıran bir cihazla ilgilenir. os update bir sürüm kurar, os rollback daha önce çalışan sürüme döner, os reset ise cihazı yeniden yeni yazılmış bir cihaz hâline getirir.

Kök Yuvaları ve Veri Bölümü

Bir IronFlockOS cihazının diski şunları tutar:

• İki kök yuvası, A ve B — her biri eksiksiz bir IronFlockOS sistemi tutar. Biri çalışır. Diğeri daha önce çalışan sistemi tutar; yeni yazılmış bir cihazda ise henüz hiçbir şey tutmaz. IronFlockOS’un kullandığı güncelleme aracı RAUC, bir sürümü çalışmayan yuvaya yazar ve bir sonraki açılışta hangi yuvanın başlayacağını kaydeder.
• Veri bölümü (/data) — uygulamalar ve verileri ile cihaz yapılandırma dosyasının (.flock) kopyasıyla birlikte cihaz ajanı. İki sistem de bu bölümü kullanır; bu yüzden bir güncelleme veya geri alma uygulamalara ve verilerine dokunmaz.
• IRONFLOCKOS bölümü (/boot/efi konumuna bağlı) — küçük bir FAT bölümü. Cihaz açılışında orada bulduğu bir .flock dosyasıyla kaydolur; os reset de isteğini oraya yazar.

Yeni bir sistem kendini kanıtlamalıdır: cihaz ajanı bu sistemden IronFlock’a ulaşıp onu iyi olarak işaretlediğinde cihaz sistemi korur. Başlamayan ya da oraya ulaşamayan bir sistem, bir sonraki yeniden başlatmada daha önce çalışan sistem lehine bırakılır. ironflock status yuvaları gösterir:

System:        IronFlockOS 0.13.0 (amd64-efi, base)
  Image:       ironflockos-amd64-efi-base (build 20261105T120000Z-g1a2b3c4)
  Slot A:      inactive, good
  Slot B:      booted, good, 0.13.0 installed 2026-11-05T14:00:00Z
  Next boot:   slot B

Komutların Çalıştığı Yer

Üç komut da IronFlockOS çalıştıran bir cihazda çalışır, root gerektirir ve harekete geçmeden önce sorar. Başka bir sistemde (macOS, IronFlockOS olmayan bir Linux, IronFlockOS yükleyici belleği) çıkış kodu 3 ile sona ererler.

• Cihazda — 0.15.0’dan sonraki IronFlockOS sürümleri ironflock aracını taşır. Cihazda oturum açın ve komutu sudo ile çalıştırın.
• Başka bir bilgisayardan — IronFlockOS 0.15.0 ve önceki sürümler ironflock aracını taşımaz. Komutu bir Linux veya macOS bilgisayardan --host ile, cihazın SSH kullanıcısı olarak çalıştırın: bu, .flock dosyasının proje sahibi için ayarladığı hesaptır, örneklerde operator. --host, çalıştırma için ironflock aracını cihaza kopyalar ve komutu orada sudo aracılığıyla çalıştırır.

ironflock --host operator@kitchen-pc os update --reboot --yes

os update ve os rollback, --yes verildiğinde aynı anda birkaç cihazda (birden fazla kez verilen --host ya da --hosts ile) çalışır. os reset bir seferde tek bir cihazda çalışır; birkaç cihazda çıkış kodu 2 ile sona erer. Genel bayraklar Bayraklar, Çıktı ve Çıkış Kodları sayfasındadır.

ironflock os update

Cihazın kanalının sunduğu IronFlockOS sürümünü, çalışmayan kök yuvasına kurar. Yeni sistem bir sonraki yeniden başlatmada ya da --reboot ile hemen başlar.

ironflock os update [flags]

Cihazın kanalı, cihaz ajanının izlediği kanaldır ve ajanın .flock dosyasındaki environment değerinden gelir: IronFlock’un test platformunda test, diğer durumlarda production. Katalogda cihazın kanalı yoksa kanal production olur. İndirme tabanı --download-base bayrağından, ardından IRONFLOCK_DL_BASE değişkeninden, ardından ajanın .flock dosyasındaki güncelleme sunucusundan (update_url) alınır (bir IronFlock Appliance’ının cihazında bu, böyle bir cihazın erişebildiği tek yer olan Appliance’ın indirme yansısıdır); bunların hiçbiri yoksa IronFlock bulutudur.

Bu sırayla şunları yapar:

1. İmzalı IronFlockOS kataloğunu okur ve kanalın (veya --version ile verilen) sürümünde cihazın görüntüsüne ait güncelleme paketini alır.
2. Hangi sürümün hangi yuvada çalıştığını, hangi sürümü hangi yuvaya kuracağını, o yuvanın şu anda neyi tuttuğunu ve indirmenin boyutunu söyler. Ardından sorar.
3. Paketi veri bölümündeki /var/cache/ironflockos klasörüne indirir. Kesilen bir indirme kaldığı yerden devam eder. Dosya yalnızca boyutu ve SHA-256 değeri kataloğunkiyle aynıysa kullanılır.
4. Paketi RAUC’a çalışmayan yuvaya kurdurur. RAUC paketin imzasını denetler, yuvaya yazar ve onu bir sonraki açılışta başlayacak yuva yapar. Yuvanın önceki içeriğinin üzerine yazılır. Paket kurulduktan sonra kaldırılır.
5. --reboot ile cihazı yeni sistemle yeniden başlatır.

Çalışan sistem yeniden başlatmaya kadar olduğu gibi kalır. Uygulamalar ve verileri kalır. Şu anda çalışan yuva sürümünü korur; yeni sürüm başlamazsa veya IronFlock’a ulaşamazsa cihaz ona geri döner.

Cihaz sürümü zaten çalıştırıyorsa ya da sürüm diğer yuvaya zaten kurulmuş ve yeniden başlatmayı bekliyorsa hiçbir şey kurulmaz ve çıkış kodu 0 olur. İkinci durumda --reboot sorar ve cihazı yeniden başlatır.

# Cihazın kanalındaki sürümü kurun; bir sonraki yeniden başlatmada başlar
sudo ironflock os update
# Kurun ve soru sormadan onunla yeniden başlatın
sudo ironflock os update --reboot --yes
# Katalogdaki daha eski bir sürümü kurun
sudo ironflock os update --version 0.13.0

İlerleme stderr’e gider: indirme ve denetimi, ardından RAUC’un adlandırdığı her adım. A yuvasında 0.13.0 çalıştıran bir cihazda os update --yes şunu yazdırır:

Download base: https://instance-registry.ironflock.com/dl (from default)
IronFlockOS catalog of 2026-11-20T09:00:00Z, signed with key 036ef3bd: production 0.14.0, test 0.14.0.
This device runs IronFlockOS 0.13.0 (ironflockos-amd64-efi-base) from slot A.
IronFlockOS 0.14.0, the release of the production channel, is installed into slot B, which holds nothing yet:
  - the bundle (580.2 MB) is downloaded into /var/cache/ironflockos
  - RAUC checks its signature and writes it into slot B
  - it starts with the next restart
Slot A keeps IronFlockOS 0.13.0: the device goes back to it when 0.14.0 does not start or does not reach IronFlock. Apps and their data stay.
Downloading: 0% (0 B of 580.2 MB)
...
Installing IronFlockOS 0.14.0 into slot B.
Installing:   0% Installing
...
Installing:  82% Copying image to rootfs.1
...
Installing: 100% Installing done.
IronFlockOS 0.14.0, the release of the production channel, is installed in slot B and starts with the next restart ('sudo reboot').

--json ile kurulum, yüzde olarak verilen installing ilerleme aşamasıdır. os update --reboot --yes --json komutunun sonucu:

{"action":"installed","image":"ironflockos-amd64-efi-base","channel":"production","version":"0.14.0","running_version":"0.13.0","slot":"B","up_to_date":false,"reboot":true}

Reddettiği durumlar (çıkış kodu 3):

• root olarak çalışmıyorsa, IronFlockOS çalıştırmayan bir makinede ve yükleyici bellekte.
• RAUC zaten bir paket kuruyorsa; bu, IronFlock Studio’nun ajan üzerinden başlattığı ya da başka bir çağrının başlattığı bir kurulum olabilir. RAUC bir seferde tek bir paket kurar.
• sürümde cihazın görüntüsü için paket yoksa.
• sürüm çalışandan eskiyse; --version onu belirtmedikçe. Diğer yuva o sürümü tutuyorsa mesaj os rollback komutunu belirtir.
• /var/cache/ironflockos içinde henüz indirilecekler için yer yoksa. Mesaj, klasördeki önceki güncellemelerin silebileceğiniz paketlerini listeler.

Hatalı komut satırları (çıkış kodu 2): birlikte verilen --channel ve --version, geçerli bir sürüm numarası olmayan bir sürüm, kataloğun içermediği bir kanal veya sürüm.

Başarısız olduğu durumlar (çıkış kodu 1): katalog doğrulanmıyor veya okunamıyor; indirme yarıda kesiliyor (gelenler /var/cache/ironflockos içinde kalır ve aynı komut indirmeye kaldığı yerden devam eder); indirilen dosya kataloğun dosyası değil; RAUC paketi reddediyor veya kuramıyor. Hata RAUC’un nedenini verir. RAUC yazmaya başlamışsa yuva hatalı olarak işaretlenir ve kullanılabilir bir sistem tutmaz; cihaz çalışan sistemi başlatmaya devam eder. Paket bir sonraki deneme için önbellekte kalır.

İndirme sırasında ya da hemen ardından basılan Ctrl-C, herhangi bir şey kurulmadan veya yeniden başlatılmadan önce komutu çıkış kodu 130 ile sonlandırır; aynı komut indirmeye kaldığı yerden devam eder. Hayır ile yanıtlanan bir soru komutu çıkış kodu 4 ile sonlandırır.

ironflock os rollback

Diğer kök yuvasını başlayacak yuva yapar ve cihazı onunla yeniden başlatır: son güncellemeden önce çalışan sisteme döner. Bunu, başlayan ama düzgün çalışmayan bir sistem için kullanın. Başlamayan ya da IronFlock’a ulaşamayan bir sistemi IronFlockOS bir sonraki yeniden başlatmada kendisi bırakır.

ironflock os rollback [flags]

Komutun kendine ait bayrağı yoktur. Cihazı her zaman yeniden başlatır: yeniden başlatma olmadan bir geri alma, bir sonraki yeniden başlatmaya kadar hiçbir şeyi değiştirmezdi.

Yalnızca sistemi bu cihazda başlamış bir yuva uygundur:

• sistemi çalışırken iyi olarak işaretlenmiş ve o zamandan beri yeniden denenmemiş bir yuva. Denenmiş ve hiç iyi olarak işaretlenmemiş bir yuva uygun değildir.
• içine hiçbir şey kurulmadığı ve hatalı olarak işaretlenmediği sürece cihazın yazıldığı yuva (A).

İki sistem de aynı veri bölümünü kullandığı için uygulamalar ve verileri kalır. Çalışmış olan yuva sürümünü korur. Yeniden başlatmadan sonra eski sistem kendini yeniden kanıtlamalıdır: cihaz ajanı bu sistemden IronFlock’a ulaştığında cihaz onu korur. Bir UEFI makinesinde, bunu daha önce yapmış bir yuva iki dakika ayakta kaldığında da korunur. O zamana kadar bir yeniden başlatma daha yeni sistemi geri getirebilir. IronFlock Studio kanalın sürümünü yeniden sunar ve os update onu kurar.

# Bir sorudan sonra diğer yuvadaki sisteme dönün
sudo ironflock os rollback
# Soru sormadan
sudo ironflock os rollback --yes

B yuvasında 0.14.0 çalıştıran bir cihazda os rollback --yes şunu yazdırır:

This device runs IronFlockOS 0.14.0 from slot B.
Slot A holds IronFlockOS 0.13.0, which ran on this device before. The rollback makes slot A the one that starts and restarts the device now.
Slot B keeps IronFlockOS 0.14.0. Apps and their data stay: both systems use the same data partition.
The device keeps IronFlockOS 0.13.0 once it has proven itself again (the device agent reaches IronFlock from it); until then a restart can bring back 0.14.0.
Rolled back to IronFlockOS 0.13.0 in slot A: the device restarts now.

--json ile slot ve version, başlayacak yuva ve onun sürümüdür (okunamıyorsa boş), from_slot ve from_version ise çalışmış olan sistemdir:

{"action":"rolled_back","slot":"A","version":"0.13.0","from_slot":"B","from_version":"0.14.0"}

Reddettiği durumlar (çıkış kodu 3), nedenini söyleyerek:

• root olarak çalışmıyorsa, IronFlockOS çalıştırmayan bir makinede, yükleyici bellekte ve RAUC bir paket kurarken.
• cihazda komutun tanımadığı bir önyükleyici varsa: komut GRUB’u (UEFI makineler) ve Raspberry Pi’nin önyükleyicisini tanır.
• diğer yuva henüz hiçbir şey tutmuyorsa (yeni yazılmış bir cihaz), denenmiş ve iyi olarak işaretlenmemiş bir sistem tutuyorsa, kurulumu tamamlanmadığı için kullanılabilir bir sistem tutmuyorsa ya da hatalı olarak işaretlenmişse.
• diğer yuva, kurulmuş bir güncellemeden ya da yeniden başlatma yapmamış bir geri almadan sonra bir sonraki yeniden başlatmayı bekliyorsa. sudo reboot onu başlatır, sudo rauc status mark-bad other onu bırakır.

Başarısız olduğu durumlar (çıkış kodu 1): RAUC yuvayı başlayacak yuva yapamıyor (hiçbir şey değiştirilmedi); yeniden başlatma başarısız oluyor (bu durumda yuva bir sonraki yeniden başlatmada başlar). Hayır ile yanıtlanan bir soru komutu çıkış kodu 4 ile sonlandırır.

ironflock os reset

IronFlockOS’un fabrika ayarlarına sıfırlamasını ister ve cihazı yeniden başlatır. Bir sonraki açılış sırasında cihaz, sahibinin, uygulamalarının ve kaydın bıraktıklarını temizler ve yeni yazılmış bir cihaz olarak başlar; -c ile yeni bir .flock dosyasının cihazı olarak kaydolur.

ironflock os reset [-c <new.flock>] [flags]

IronFlockOS 0.15.0, fabrika ayarlarına sıfırlamayı içeren ilk sürümdür. Daha eski bir sürümde komut reddeder; os update daha yeni bir sürüm kurar.

Sıfırlama, veri bölümünde ve iki kök yuvasında şunları temizler:

• uygulamaları verileriyle birlikte ve Docker’ın konteynerlerini, görüntülerini ve volume’larını.
• cihazın IronFlock’taki kimliğini: .flock dosyasının kopyası, veritabanı ve hizmetiyle birlikte cihaz ajanı. Ana bilgisayar adı ironflockos değerine döner ve makine kimliği yeniden oluşturulur.
• SSH kullanıcısını ve diğer tüm kullanıcı hesaplarını, ana dizinleri ve sudo kurallarıyla birlikte.
• günlükleri, SSH ana bilgisayar anahtarlarını, indirilmiş güncellemeleri ve gerçek zamanlı çalışma için yapılan ince ayarları.
• --keep-network olmadan: ağ profillerini (WiFi dahil), proxy ayarını (proxy.conf) ve PTP ayarını (ptp.conf).

Kök yuvalarındaki IronFlockOS sistemlerini, yani çalışanı ve bir sistem tutuyorsa diğerini, ve RAUC’un bunlara ilişkin kaydını korur; böylece güncellemeler ve geri almalar önceki gibi çalışır. --keep-network ile yukarıdaki ağ ayarlarını da korur. Sistemin kendisinde elle yapılan değişiklikleri, örneğin bir paketi veya /etc içindeki bir dosyayı geri almaz; bunu IronFlockOS’u os flash ile diske yeniden yazmak yapar.

Bu sırayla şunları yapar:

1. Cihazın istendiği gibi yapmayacağı şeyleri reddeder (aşağıda) ve -c ile verilen .flock dosyasını denetler: adı *.flock olan, en fazla 5 MiB büyüklüğünde, secret ve device_key içeren ve name ile serial_number değerleri sade adlar olan bir JSON nesnesi.
2. stderr’de nelerin gideceğini, nelerin kalacağını, cihazın nasıl geri geleceğini ve son sıfırlamasının ne yaptığını söyler, ardından cihazın adını yazmanızı ister: ajanın .flock dosyasındaki, ironflock status komutunun gösterdiği ad ya da kaydolmamış bir cihazın ana bilgisayar adı. Başka herhangi bir yanıt, yalnızca Enter da dahil, hayır anlamına gelir.
3. Cihazın kendi denetimi isteği kabul ettikten sonra isteği IRONFLOCKOS bölümüne yazar. Orada zaten bulunan bir isteğin yerine bu yazılır; bu, kendine ait üç denemesi olan yeni bir istektir.
4. -c ile, cihaz en yenisiyle kaydolduğu için bölümdeki diğer tüm .flock dosyalarını kaldırır ve yeni .flock dosyasını oraya yazar. Bu başarısız olursa istek yeniden kaldırılır.
5. Cihazı yeniden başlatır. Bir sonraki açılış sırasında cihaz kendini saniyeler içinde (yavaş bir SD kartta dakikalar içinde) sıfırlar, bir kez daha yeniden başlar ve yeni SSH ana bilgisayar anahtarlarıyla, yeni yazılmış bir cihaz olarak başlar.

Sıfırlamadan sonra, -c ile cihaz o .flock dosyasının cihazı olarak kaydolur ve dosyanın SSH kullanıcısı olarak SSH üzerinden erişilebilir. -c olmadan IRONFLOCKOS bölümünde bir .flock dosyası bekler ve yalnızca konsolundan erişilebilir: SSH kullanıcısı ve IronFlock bağlantısı yoktur. Cihaza yapılan bir SSH bağlantısı, --host bağlantısı da, yeniden başlatmayla sona erer; -c olmadan hiçbiri geri gelmez.

Not: Cihaza yalnızca ağ üzerinden erişiyorsanız yeni .flock dosyasını -c ile verin. Bu dosya olmadan cihazı yeniden çevrimiçi yapmak için birinin cihazın başında olması gerekir.

Başarısız olan bir deneme cihazı yeniden başlatmaz: cihaz olduğu gibi açılır ve bir kişinin ya da bir güncellemenin tetiklediği bir sonraki açılış yeniden dener. Üç başarısız denemeden sonra sıfırlama vazgeçer ve cihaz orada ne varsa onunla başlar. Eski verileriyle önceki cihaz olarak kalır ve eski kimliğiyle çevrimiçidir; istekle gelen .flock dosyası ve proxy ayarı kaldırılır. Sona ermiş bir istek, tamamlanmış ya da vazgeçilmiş olsun, hiçbir yuvada ve hiçbir güncellemeden sonra bir daha tetiklenmez. Yanıt vermeyen bir disk bir denemeyi 25 dakikaya kadar uzatabilir. ironflock status, başarısız olmuş veya vazgeçilmiş bir sıfırlamayı Last reset: satırında gösterir.

Komut sormadan önce cihazın kaydettiği son sıfırlamayı gösterir:

# Cihazı sıfırlayın; ardından cihaz bir .flock dosyası bekler
sudo ironflock os reset
# Cihazı sıfırlayın ve onu new-device.flock dosyasının cihazı yapın
sudo ironflock os reset -c new-device.flock
# Ağ ayarlarını koruyun, soru sormadan
sudo ironflock os reset --keep-network --yes
# Başka bir bilgisayardan, IronFlockOS 0.15.0 üzerinde
ironflock --host operator@edge-01 os reset -c new-device.flock

Son sıfırlaması vazgeçmiş olan edge-01 cihazında, soruya ad yazıldığında os reset -c kitchen-pi.flock şunu yazdırır:

This device runs IronFlockOS 0.15.0 from slot B and is the IronFlock device edge-01.
The last factory reset of this device: gave up after 3 attempts at 2026-11-11T09:00:00Z: the data partition is not the partition named data on the disk of the root slot; /data holds the old data; left of the old owner: the data partition, the booted root slot, the other root slot; the device stayed the device it was, online with its old identity, and the .flock and proxy.conf that came with the request were removed.
What can be done: request the reset again, as this command does now, with three new attempts; or write IronFlockOS to the device's disk anew ('ironflock os flash'), which clears everything.
The factory reset restarts the device now. During the next boot the device resets itself, in seconds (minutes on a slow SD card), and restarts once more. It clears:
  - the apps with their data, and Docker's containers, images and volumes
  - the device's identity at IronFlock: the agent with its copy of the .flock and its database; the hostname goes back to ironflockos
  - the SSH user and every other user account, with their home folders
  - the logs, the SSH host keys and the downloaded updates
  - the network profiles (the WiFi among them), the proxy setting and the PTP setting
It keeps IronFlockOS 0.15.0 in slot B, which runs, and IronFlockOS 0.14.0 in slot A, so updates and rollbacks work as before.
It does not undo what was changed by hand in the system itself, such as a package or a file in /etc.
Then the device starts as a freshly written one with kitchen-pi.flock, which goes onto its IRONFLOCKOS partition: it enrolls as kitchen-pi and can be reached over SSH as operator, with the device key of that .flock and new SSH host keys.
An attempt that fails does not restart the device: it comes up as it is, and its next start tries again; after three failed attempts the reset gives up, and the device starts with what is there. 'ironflock status' shows a failed or given-up reset.
An SSH connection to the device, also the one of --host, ends with the restart.
? Type the device's name, edge-01, to reset it: edge-01
Factory reset requested: the device restarts now, resets itself and enrolls as kitchen-pi.

os reset --keep-network --yes --json komutunun sonucu:

{"action":"reset","device":"edge-01","keep_network":true}

Reddettiği durumlar (çıkış kodu 3), nedenini ve ne yapılacağını söyleyerek:

• root olarak çalışmıyorsa, IronFlockOS çalıştırmayan bir makinede, yükleyici bellekte ve RAUC bir paket kurarken.
• IronFlockOS’ta fabrika ayarlarına sıfırlama yoksa: bunu daha yeni bir sürüm getirir, o sürümü de os update kurar.
• /boot/efi bağlı IRONFLOCKOS bölümü değilse: orada hiçbir şey bağlı değil ya da FAT dışında bir dosya sistemi bağlı.
• bir sıfırlama başlamışsa: bir sonraki açılışta devam eder ve o zamana kadar hiçbir şey değiştirilmemelidir. Mesaj son denemeyi verir.
• -c olmadan, IRONFLOCKOS bölümünde bir .flock dosyası duruyorsa: sıfırlamadan sonra cihaz bir dosya beklemek yerine bu dosyayla kaydolurdu.
• bir sonraki açılışta başlayacak olan, iyi olarak işaretlenmiş çalışan sistem değilse. Bir güncelleme veya geri alma yeniden başlatmasını bekliyordur: sudo reboot onu başlatır, sudo rauc status mark-bad other onu bırakır. Ya da çalışan sistem henüz iyi olarak işaretlenmemiştir: sudo rauc status mark-good onu korur, os rollback geri döner.
• cihazın kendi denetimi isteği kabul etmiyorsa: hiçbir şey istenmez ve mesaj cihazın nedenini verir.

Başarısız olduğu durumlar (çıkış kodu 1):

• bağlama tablosu okunamıyor; bu yüzden komut /boot/efi konumunun IRONFLOCKOS bölümü olup olmadığını ayırt edemiyor. Hiçbir şey yazılmaz.
• -c ile verilen .flock dosyası geçerli değil.
• istek veya .flock dosyası yazılamıyor ya da başka bir .flock dosyası kaldırılamıyor. İstek geri alınır ve hata nelerin gittiğini söyler.
• yeniden başlatma başarısız oluyor. Bu durumda cihaz bir sonraki açılışında kendini sıfırlar; /boot/efi/factory-reset.conf dosyasını ve .flock dosyasını IRONFLOCKOS bölümünden kaldırmak sıfırlamayı iptal eder.

Komut isteğini yazarken gelen Ctrl-C, SIGTERM veya kopan bir SSH oturumu, komutun isteği geri almasına yol açar: komut çıkış kodu 130 ile sona erer ve cihaz yeniden başlamaz. Soruda yanlış yazılan bir ad komutu çıkış kodu 4 ile sonlandırır.

Tüm komutların çıkış kodları Bayraklar, Çıktı ve Çıkış Kodları sayfasında açıklanır. --host üzerinden çıkış kodu 255, SSH bağlantısının başarısız olduğu anlamına gelir.