ish-app

ish: Run a Linux Shell on iOS

iSH brings a Linux shell to iOS through usermode x86 emulation and syscall translation. It is suited to users who want a lightweight command-line environment on an iPhone or iPad, with compatibility and performance shaped by its emulation approach.

COther licenseLinuxShelliOS
View on GitHub Compare
Stars
20.5k
Forks
1.5k
Stars, last 30 days
+138

Our take

Health score

50/100

How it is scored
Activity
62
Community
64
Issues
51
Pull requests
24

+138 stars in the last 30 days

  • Releases more often than 76% of the projects we track
  • Slower to merge pull requests than 99% of the projects we track

Project history

Daily GitHub snapshots since Oct 7, 2026. History covers stars and forks; health signals are not tracked historically.

Selected snapshot

Stars

20,737

Forks

1,608

Change since Nov 16, 2026: +6 stars·0 forks

Overview

iSH runs a Linux shell on iOS by emulating usermode x86 and translating system calls. It gives users access to a Linux command-line environment on Apple mobile devices without requiring a separate Linux machine.

The project is aimed at people who want shell access on iOS and developers interested in its emulator and interpreter implementation. See the project site, wiki, and current issues for usage guidance and status.

Key Features

  • Runs a Linux shell on iOS using usermode x86 emulation.
  • Translates system calls between the emulated environment and iOS.
  • Supports an Alpine Linux filesystem, including running /bin/sh inside it.
  • Offers a command-line build for testing with Meson and Ninja.
  • Includes logging channels for system calls, executed instructions, and other debug messages.
  • Provides a ptraceomatic tool to single-step a program and compare registers on supported Linux systems.

Use Cases

  • iPhone and iPad users who want to explore a Linux shell without switching devices.
  • Developers who need a portable command-line environment for experimentation or lightweight tasks.
  • Emulator and systems programmers studying syscall translation or instruction interpretation.
  • Contributors debugging behavior through the project's logging channels or command-line tools.

Getting Started

Install iSH from the App Store, or join the TestFlight beta. For building from source and setting up an Alpine filesystem, follow the README and wiki.

Alternatives

  • Podroid: Podroid runs Alpine Linux in a rootless VM on Android, while iSH provides a Linux shell on iOS through x86 emulation and syscall translation.
ProjectLanguageLicenseStarsStatus
ishCOther20.5kNot checked yet
PodroidKotlinGPL-2.03.6kActive

Considerations

  • This is an emulated environment, not a native Linux installation. Compatibility and speed may differ from running Linux directly.
  • Building requires Python 3, Meson, Ninja, Clang and LLD, SQLite, and libarchive. Clone with submodules enabled.
  • The README describes some interpreter code as heavily assembly-based and difficult to maintain.
  • The repository reports 642 open issues. Check the issues tab for current project status and known limitations.

Found this useful?

Share it with someone who would like ish.

Comparisons