Skip to content

Instantly share code, notes, and snippets.

@ViniciusGibran
Created May 21, 2024 19:28
Show Gist options
  • Select an option

  • Save ViniciusGibran/49ac830f8b488b44e794e09b17dd1ed4 to your computer and use it in GitHub Desktop.

Select an option

Save ViniciusGibran/49ac830f8b488b44e794e09b17dd1ed4 to your computer and use it in GitHub Desktop.

How to Install an iOS App Distributed via GitHub

Prerequisites

  1. iOS Device: Ensure you have an iOS device connected to the internet.
  2. Safari Browser: Use Safari to open the installation link.

Step-by-Step Installation Guide

  1. Open Safari:

    • On your iOS device, open the Safari browser.
  2. Navigate to the Installation Link:

    • Enter the URL of the GitHub page where the installation link is provided. This URL should look something like https://github.com/yourusername/yourrepository.
  3. Click the Install Link:

    • On the GitHub page (or a dedicated webpage), locate and click the installation link. It should look like this:
    <a href="itms-services://?action=download-manifest&url=https://raw.githubusercontent.com/yourusername/yourrepository/main/distribution/manifest.plist">Install Your App</a>
    • The link will initiate the installation process by opening the itms-services protocol.
  4. Confirm Installation:

    • A pop-up will appear asking for confirmation to install the app. Tap "Install".
  5. Wait for Installation:

    • The app will begin installing on your home screen. Wait for the installation to complete. This may take a few moments.
  6. Trust the Enterprise Certificate:

    • Once the app is installed, go to Settings > General > Device Management on your iOS device.
    • Find your enterprise certificate (it will display the name of your organization).
    • Tap on the certificate and select "Trust [Organization Name]".
  7. Open the App:

    • After trusting the certificate, navigate back to your home screen.
    • Tap on the app icon to open it.

Troubleshooting Tips

  • Untrusted Enterprise Developer: If you see a message saying "Untrusted Enterprise Developer" when you try to open the app, make sure you have trusted the enterprise certificate as described in Step 6.
  • Network Issues: Ensure your iOS device is connected to a stable internet connection during the installation process.
  • Expired Certificate: If the app fails to install, it might be due to an expired enterprise certificate. Contact your organization's IT department for assistance.
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment