Skip to main content

Linux Instructions

Before you start, make sure to have all steps completed found in the prerequisites!

  1. Make sure you have usbmuxd and either Docker or Podman installed on your machine.

  2. Plug in your iDevice. If you recieve a prompt, select "trust" and enter your passcode.

  3. Now, run Altcon with Docker or Podman using the following commands (may require sudo):

Docker setup:

docker run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon

Podman setup:

podman run --rm -it -v ${PWD}/:/mnt/ -v /var/run/usbmuxd:/var/run/usbmuxd ghcr.io/sidestore/altcon
  1. Altcon will pair with your device. When you recieve another prompt, select "trust" and enter your passcode again.
  2. On your secondary device, do the following:
    • Approve the "Developer App" under your Apple ID's email (you can find this in Settings, under "General", and then "VPN & Device Management").
    • Open the Settings app.
    • Navigate to the 'Privacy and Security' section.
    • Turn on 'Developer Mode' at the bottom.
  3. Open SideStore and select "allow" for prompts until SideStore requests a pairing file. Exit the app now.

Now, proceed to generate your pairing file.