Skip to main content

Linux Instructions

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

  1. Ensure you have usbmuxd installed and updated by running sudo apt install -y usbmuxd in the Linux terminal.

  2. Install either Docker or Podman on your machine.

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

  4. 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 receive 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.

Now, proceed to generate your pairing file.