# sickcodes/Docker-eyeOS

Run iPhone (xnu-arm64) in a Docker container! Supports KVM + iOS kernel debugging (GDB)! Run xnu-qemu-arm64 in Docker! Works on ANY device.

Repository: https://github.com/sickcodes/Docker-eyeOS
Canonical: https://ross.abutalabs.com/products/docker-eyeos
Homepage: https://hub.docker.com/r/sickcodes/docker-eyeos
Language: Shell
License: GPL-3.0
License Family: copyleft
Topics: docker, ios, kernel, gdb, xnu, arm
Last push: 2022-01-18T03:51:57+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 2162, "days_push": 1688, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1061, forks 103 (observed 2026-08-28T04:03:25.861083+00:00)

## What it is
A Docker container that boots the iPhone's iOS xnu kernel (arm64) under QEMU with KVM acceleration, exposing SSH and GDB ports for kernel debugging. It lets researchers run and debug the iOS kernel on any Linux-capable host.

## Use cases
- run iOS kernel in a docker container
- debug the iOS xnu kernel with gdb
- emulate an iPhone on linux with qemu
- kernel security research on iOS arm64
- boot xnu-qemu-arm64 with KVM
- ssh into an emulated iOS system

## When to choose
- you need to step through the iOS kernel in GDB on Linux
- you want a reproducible, containerized iOS kernel research environment
- you're doing arm64 kernel or security research without physical devices

## When to avoid
- you want to run iOS apps with a graphical UI - display support is incomplete
- you need a maintained, actively updated tool - last release was 2022
- you lack KVM or can't run privileged containers
- you want a full iOS device emulator rather than kernel-level access

## Facets
- artifact type: application
- maturity: maintenance
- function: simulation, developer-tools, container-runtime
- domain: security, reverse-engineering, operating-systems, developer-tools
- platform: cli
- tags: ios-emulation, xnu-kernel, qemu, gdb-debugging, kvm, arm64, kernel-debugging, iphone, docker, linux

## Member repositories
- sickcodes/Docker-eyeOS (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:03:25.861083+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T06:56:52.190877+00:00, confidence not recorded.
  - readme: https://github.com/sickcodes/Docker-eyeOS (fetched 2026-08-28T04:03:25.861083+00:00, sha d081e8283194)
  - homepage: https://hub.docker.com/r/sickcodes/docker-eyeos (fetched 2026-08-29T12:58:35.525576+00:00, sha 2925a9800b96)
  - site_page: https://docs.docker.com/docker-hub (fetched 2026-08-29T12:58:35.534714+00:00, sha caaa18892709)
  - site_page: https://www.docker.com/docs (fetched 2026-08-29T12:58:35.536352+00:00, sha aeada2272712)
  - site_page: https://www.docker.com/company (fetched 2026-08-29T12:58:35.538099+00:00, sha 05ab59b2bc29)
- Data as of 2026-08-30T08:39:29.467469+00:00.