AltServer-Linux

AltServer for AltStore, but on-device

Usage

• 📦 Install IPA

  ./AltServer -u [UDID] -a [AppleID account] -p [AppleID password] [ipaPath.ipa]

• ➰ Running as AltServer Daemon

  ./AltServer

• 🧪 Full Usage

  Usage:  AltServer-Linux options [ ipa-file ]
    -h  --help             Display this usage information.
    -u  --udid UDID        Device's UDID, only needed when installing IPA.
    -a  --appleID AppleID  Apple ID to sign the ipa, only needed when installing IPA.
    -p  --password passwd  Password of Apple ID, only needed when installing IPA.
    -d  --debug            Print debug output, can be used several times to increase debug level.
  
  The following environment var can be set for some special situation:
    - ALTSERVER_ANISETTE_SERVER: Set to custom anisette server URL
            if not set, the default one: https://armconverter.com/anisette/irGb3Quww8zrhgqnzmrx, is used
    - ALTSERVER_NO_SUBSCRIBE: (*unused*) Please enable this for usbmuxd server that do not correctly usbmuxd_listen interfaces

Download

• Github Release
• altserver-linux-curve-git ^AUR
• Nightly Builds are available as Workflow Artifacts

---

Offline Anisette

Offline Anisette Data Generation (i.e. with Sideloadly) is supported.
Run alt_anisette_server and specify the custom server url through the environment variable ALTSERVER_ANISETTE_SERVER.

Wi-Fi Refresh

netmuxd supports network devices since versions >0.1.1.

To use netmuxd stop the original usbmuxd and run netmuxd before starting altserver.

If netmuxd does not work, please try using special env var ALTSERVER_NO_SUBSCRIBE. Enabling this would disable auto-refresh when plugged-in of USB devices

---

Advanced: Build Instructions

If you have issues with building you may want to checkout the build workflow

Note
The following build instructions apply to archlinux only, but should be roughly the same on other distros.

• 🚧 Install Build Dependencies

  yay -S boost clang cmake ninja git libcorecrypto-git zlib python3 avahi

• 📦 Grab the source

  git clone --recursive https://github.com/NyaMisty/AltServer-Linux
  cd AltServer-Linux

• 🏗️ Build

  mkdir build && cd build
  cmake .. && cmake --build . --config Release