appleseum

Your apps are here. Even apps delisted from the App Store — install them on iPhone/iPad without a cable.

View on GitHub

Appleseum

README на русском · Apache License 2.0

🚀 Your apps are here. Even apps delisted from the App Store — install them on iPhone/iPad without a cable.

Why use Appleseum · Ways to use Appleseum · Install · Using Appleseum after launch · Launch options · FAQ · Similar projects · Third-Party Dependencies

1. Why use Appleseum

Appleseum is a utility for installing apps delisted from the App Store on your iPhone/iPad — apps you can no longer find in search or download.

Typical situations:

[!WARNING] Appleseum is not an official Apple utility. Use it at your own risk; the authors accept no responsibility for any problems.

If you plan to sign in to an Apple account, make sure you are using the original version of Appleseum from this repository. Avoid copies on unfamiliar websites or access provided by strangers: a modified version could capture the credentials you enter and give others access to the account.

Appleseum app library

2. Ways to use Appleseum

Appleseum consists of a server component and a web interface that opens in the built-in Safari browser on the iPhone or iPad you want to install apps on. Whether you need another device depends on how you choose to use the utility (a cable is never needed):

2.1. Local mode

[!WARNING] For safe access over a local network, use your home network, which you control and trust. In both local modes, the web interface uses http without encrypting all traffic. Appleseum checks the request’s Host to protect against DNS rebinding, but an attacker carrying out a man-in-the-middle attack within the network could replace the http page and steal your Apple account credentials if you enter them to sign in.

[!NOTE] When running Appleseum’s server component on an iPhone/iPad through iSH:

  • Make sure Airplane Mode and your VPN are off before starting Appleseum and remain off while it is running;
  • To run in the background, Appleseum uses iSH’s standard location-based mechanism (the utility does not use location data in any way, which you can verify in the source code). Allow location and Local Network access if prompted; even with these permissions, the OS may stop iSH after a while;
  • In this mode, the utility may run more slowly due to emulation of 32-bit x86 code (linux/386).

2.1.1. Local mode: two devices

This is the main, recommended option. Both devices must be on the same local wireless network; usually, connecting them to the same Wi-Fi access point is enough.

First device: server component

Any device running Windows, macOS, Linux, iOS/iPadOS (via iSH) or Android (via Termux) will work — for example, a home computer, a laptop or another iPhone (such as your old one). For most users, a computer is the easiest place to run it.

Install and start Appleseum. Links to the web interface should appear in the terminal output; you will need them in the next step.

Second device: iPhone/iPad where you need the apps

From the links shown on the first device, choose one with an address in your wireless network’s subnet, then open it in Safari. If you are unsure which link to choose, try them one by one — at least one should open the web interface. For the next steps, see how to use Appleseum after launch.

2.1.2. Local mode: one device

The server component runs on the same iPhone/iPad where you need the apps. Install iSH from the App Store on it. Within iSH, install and start Appleseum. Then open any link from the terminal output in Safari; e.g., the first one. Keep the conditions for running iSH in the background in mind. For the next steps, see how to use Appleseum after launch.

2.2. Public server

This mode is for a group of people you trust (family, friends or colleagues) and for your own access “from anywhere”. For secure operation, access is available only over https (a valid https certificate is required).

A typical scenario: someone hands you an iPhone and asks you to restore apps delisted from the App Store. On that device, you open your personal server running Appleseum in Safari and quickly solve the problem. No extra software (including iSH) or other devices nearby are needed, and the happy owner declares you a tech wizard.

[!WARNING] Features of this mode:

  • Not designed for heavy workloads or large-scale use by the general public; in particular, Apple may restrict or block access if too many requests come from one server;
  • Safety depends on the server operator.

First device: server component

The server can be located anywhere, for example on the internet.

Install and start Appleseum in public mode:

Set up a reverse proxy for https access. It must forward requests to Appleseum’s http port (8080 by default), preserving the external hostname and port. Keep Appleseum’s http port accessible only to the proxy. With the provided compose.public.yaml settings, the proxy connects to 127.0.0.1:8080 on the device running Docker.

Second device: iPhone/iPad where you need the apps

It must have network connectivity to the server. Open the server’s configured https address in Safari. For the next steps, see how to use Appleseum after launch.

Sign-in data and access

Unlike in the local modes, you sign in to an Apple account separately for each browser session. Sign-in is also required to upload existing .ipa files. Clearing your browser’s data removes the key used to decrypt saved passwords, so you will need to sign in again.

The administrator’s login and temporary password appear in the server’s terminal output, or docker logs appleseum for Docker. The administrator’s password changes after each restart. Appleseum supports launch options; use --help to see the list.

3. Install

Assuming you have already chosen a mode, you should now install Appleseum’s server component. You can download and run the appropriate executable from the latest release. Alternatively, you can “install” the utility from the command line or use Docker:

3.1. Windows

Open PowerShell and paste:

irm https://raw.githubusercontent.com/hyperion-cs/appleseum/main/install/windows.ps1 | iex

The installer will show the command for future launches.

3.2. macOS, Linux, iOS/iPadOS or Android

On iOS/iPadOS, use iSH; on Android, use Termux.

Open the terminal and run:

u=https://raw.githubusercontent.com/hyperion-cs/appleseum/main/install/unix.sh; (curl -fsSL $u || wget -qO- $u) | sh

The installer will show the command for future launches.

3.3. Docker

3.3.1. Run with docker run

Run with Docker using host networking:

docker run -d --name appleseum --network host \
  -v appleseum-data:/data ghcr.io/hyperion-cs/appleseum:latest

[!NOTE] On Docker Desktop, --network host requires version 4.34 or later. Under Settings → Network, make sure Enable host networking is checked. If you enable it, select Apply and restart.

Or publish the ports explicitly:

docker run -d --name appleseum -p 8080:8080 -p 8443:8443 \
  -v appleseum-data:/data ghcr.io/hyperion-cs/appleseum:latest

To see the links to the web interface, check the utility’s output:

docker logs appleseum

Your downloads and settings are stored in the appleseum-data volume, which is preserved when you remove the container. docker stop appleseum stops the server; docker start appleseum starts it again.

3.3.2. Run with Docker Compose

Basic Compose templates are provided, and you can edit them to suit your needs. For local mode, download the file and start the server:

curl -fsSLo compose.local.yaml https://raw.githubusercontent.com/hyperion-cs/appleseum/main/compose.local.yaml
docker compose -f compose.local.yaml up -d

[!NOTE] If you use Docker Desktop, the network_mode: host setting in compose.local.yaml requires version 4.34 or later. Under Settings → Network, make sure Enable host networking is checked. If you enable it, select Apply and restart.

For public mode, use the compose.public.yaml template. Both files use the same appleseum-data volume. The container restarts with Docker. When switching from docker run to Compose, stop and remove the previous appleseum container.

3.4. Updating the utility

Appleseum will update the storage format automatically by applying the appropriate migrations if needed. Updating does not affect apps already installed on your iPhone/iPad.

4. Using Appleseum after launch

Assuming you have already installed Appleseum and also started the server component and opened the web interface, you can now continue:

  1. On first use, you will probably need to sign in to an Apple account. In either local mode, you can skip this step if you plan to upload existing .ipa files to the library for installation. Enter a two-factor authentication (2FA) code if prompted during sign-in;
  2. Add the apps you need to the local library in one of two ways:
    • From the App Store catalog: in “Available”, select the apps you want and choose “Download”;
    • Manually: upload .ipa files in “Downloads” (choose “More” → “Import .ipa” → “Choose files”, or use drag and drop).
  3. In “Downloads”, select the apps to install and choose “Start hosting”;
  4. In the window that appears, choose “Install” and confirm installation when iOS/iPadOS asks;
  5. Wait for Appleseum to confirm that the transfer is complete, then go to the Home Screen and check that the apps are installed (if they are still installing, wait until they finish).

[!NOTE] Keep Appleseum’s server component running until the .ipa files have finished transferring to the iPhone/iPad; progress is shown in the web interface. Ctrl+C in the terminal stops the utility.

5. Launch options

Name Type Default Description
--http port|ip:port int|string 8080 http listener for frontend, our API and .ipa files. If only a port is specified, the server listens on all network interfaces.
--https port|ip:port int|string 8443; disabled with --public https listener for installation manifests, using a self-signed certificate. If only a port is specified, the server listens on all network interfaces. Cannot be specified with --public.
--localhost-resolver bonjour|nip string bonjour Hostname resolver for same-device installation in iSH.
bonjour: use the device’s local Bonjour service (default).
nip: resolve the local ip via nip.io.
Warning: nip uses third-party DNS outside this device and Apple; no http requests are sent to nip.io.
--public bool false Use separate browser sessions. Disable the built-in https listener and serve everything on --http. Requires a reverse proxy with a valid https certificate for the entire utility. Cannot be combined with --debug=web or --https. See section 2.2.
--shared-library bool false Share the local library among all users; otherwise, show only the current account’s apps. Requires --public. Other accounts’ apps remain read-only.
--data path string Windows: %LOCALAPPDATA%\Appleseum\data
macOS: ~/Library/Application Support/Appleseum
Linux, Android (Termux), iOS/iPadOS (iSH): ~/.local/share/appleseum
Runtime data directory. Linux, Android (Termux) and iOS/iPadOS (iSH) respect an absolute XDG_DATA_HOME. The selected absolute path is printed at startup.
--settings bool false Enable the settings tab and its API.
--debug[=web|raw] string — --debug or --debug=web: enable the debug tab, http logs and internal errors. Web logs are stored in logs/ inside the data directory. --debug=raw: write process, network and database diagnostics to debug.log in the current directory, without the debug tab. Only web mode is incompatible with --public.
-h, --help — — Show this help and exit.

6. FAQ

6.1. Is there a public Appleseum server run by the authors?

No. In that case, you could not verify that the server was running the code from this repository without any modifications. You should also consider the limitations of public mode.

6.2. Could my Apple account be stolen?

No, as long as you follow the recommendations in this README. The original version uses your credentials only to communicate with Apple’s servers and does not send them to the project’s authors and/or unrelated services; you can check this in the source code. The authors devote substantial time to security, taking all necessary steps (within their capabilities) to prevent data leaks. Appleseum does not store passwords in plaintext. And in public mode, the decryption key is saved only in the browser on the user’s device, i.e., not stored on the server.

6.3. Will I need to enter a 2FA code every time?

Usually, a code is needed only on the first sign-in. To Apple, Appleseum looks like a real device running macOS, and its device parameters are saved locally between launches.

6.4. Which apps are available in the catalog?

After you sign in to your Apple account, the catalog gives you access to every app you have ever obtained with that account, regardless of which device you installed it on. This includes apps delisted from the App Store; installing them is Appleseum’s main purpose. Apple counts apps obtained for free as “purchases” too.

6.5. Can I install an app that is not in my Apple account’s purchase history?

Yes. In Appleseum, you can download it using another Apple account whose purchase history includes it, or import an existing .ipa file. You can collect apps from different Apple accounts in the local library and install them even on an iPhone/iPad that has never had them before. There is no need to switch accounts on the target device.

6.6. Can I update an app delisted from the App Store?

Yes, but for now you need to uninstall the old version before installing the new one, which may erase the app’s local data. We are working on a way to update apps without uninstalling them.

6.7. Is it safe to share my .ipa files?

For new downloads, Appleseum removes the account login (email address or phone number), name, full account ID and download dates from .ipa metadata. Apple licenses remain unchanged, so the file may still contain the account holder’s first and last name and part of their account ID. These details are not intended for signing in to the Apple account or unlocking a device, but they reveal some personal information. Existing library files and imported .ipa files are left unchanged and may contain more personal information.

6.8. Which iOS/iPadOS versions does Appleseum work with?

App installation through Appleseum has been successfully tested in all modes on Apple devices running the iOS/iPadOS versions listed below. App files must also be compatible with your device: they usually are, but there may be restrictions, e.g., based on the OS version.

Device Tested OS versions
iPhone iOS 17.3.1, 26.5.2, 27.2.1
iPad iPadOS 26.7.1

6.9. Can I use Appleseum without an internet connection or an Apple sign-in?

Yes, in either local mode. You can import existing .ipa files or use files already in the library to install apps without an internet connection or signing in to Apple.

6.10. How is Appleseum distributed?

Appleseum is written in pure Go and comes as a single lightweight, self-contained executable. Installation methods are described in section 3.

6.11. Where can I learn more about how Appleseum works internally?

6.12. How can I build Appleseum from source?

You can use the release workflow as a reference.

7. Similar projects

8. Third-Party Dependencies