Install

Install LinPad.

A step-by-step guide for people who have never sideloaded an app. Plan about 20 minutes the first time; after that, updates take a tap.

What you need

Pick a way to install

recommended

SideStore

Installs and refreshes apps on the iPad itself. After a one-time setup on a computer you never need the computer again.

Steps

AltStore

Similar, but refreshing needs AltServer running on a computer on the same Wi-Fi.

Steps

Sideloadly or iloader

Install the IPA straight from a computer. You redo it every 7 days with a free Apple ID.

Steps

SideStore, step by step

SideStore's own guide is at docs.sidestore.io; this is the same path, in short.

  1. Install LocalDevVPN on the iPad

    Get LocalDevVPN from the App Store. It is a VPN that only loops back to the iPad itself: no traffic leaves the device. SideStore uses it to talk to the iPad's own install service, and needs it switched on whenever it installs or refreshes apps.

  2. Install iloader on your computer

    Download iloader for macOS, Windows or Linux. On Windows, install iTunes from Apple's website first so the cable connection works.

  3. Connect the iPad and install SideStore

    Plug the iPad in with a cable, unlock it and tap Trust. In iloader, sign in with your Apple ID, pick the iPad and choose Install SideStore. iloader also puts the pairing file SideStore needs on the iPad.

  4. Trust your Apple ID on the iPad

    SettingsGeneralVPN & Device Management then tap your Apple ID under Developer App and tap Trust.

  5. Turn on Developer Mode

    SettingsPrivacy & SecurityDeveloper Mode Switch it on; the iPad restarts and asks you to confirm.

  6. Open SideStore

    Connect LocalDevVPN, open SideStore and sign in with the same Apple ID. In My Apps, tap the 7 DAYS button next to SideStore once to refresh it.

  7. Add LinPad

    On this iPad, open the download page and tap Add to SideStore, or in SideStore go to Sources › + and paste:

    https://raw.githubusercontent.com/fspecii/LinPad/main/release/source.json

    Then install LinPad from the source. Keep LocalDevVPN connected while it installs.

A free Apple ID can have 3 sideloaded apps at once, SideStore included, and register 10 new apps a week. SideStore, LinPad and StikDebug (for fast mode) fill those 3 slots. App Store apps like LocalDevVPN do not count.

AltStore Classic

  1. Set up AltStore

    Follow AltStore's guide: install AltServer on your computer, then AltStore on the iPad.

  2. Trust and Developer Mode

    The same two settings as below.

  3. Add LinPad

    On your iPad, tap the button below to open AltStore Classic, confirm adding the source, then install LinPad. You can also use Browse › Sources › + with the source address above.

    Add to AltStore Classic

  4. Refresh weekly

    AltStore refreshes apps when AltServer is running on a computer on the same Wi-Fi.

With a computer only: Sideloadly or iloader

  1. Download the IPA

    Get LinPad-…ipa from Download on your computer.

  2. Install it with your Apple ID

    Open iloader or Sideloadly, connect the iPad, choose the IPA and sign in with your Apple ID.

  3. Trust and Developer Mode

    See below, then open LinPad.

  4. Every 7 days

    With a free Apple ID, install the same IPA again before it expires. Install it over the old one; never delete LinPad first.

Trust and Developer Mode

iPadOS asks for both the first time you run an app you signed yourself.

The 7-day limit

Apps signed with a free Apple ID stop opening after 7 days. Nothing is lost: refresh the app and it opens again with your files. SideStore does this on the iPad, in the background or with the day counter in My Apps, as long as LocalDevVPN can connect. With AltStore, AltServer does it over Wi-Fi. With Sideloadly or iloader, you reinstall from the computer. A paid Apple Developer account ($99 a year) makes it a year.

First launch

First launch: the welcome screen while Linux unpacks (“Unpacking Linux… 348 of 606 MB”). Current development build in the iPad simulator.

LinPad unpacks its Linux system once, while the welcome screen is up: the ring shows unpacking, then configuring, then “Linux is ready”. In the simulator on an M4 Mac that took under half a minute; on an iPad expect longer. Keep LinPad open until it finishes; if it is interrupted, it starts over cleanly next time.

A short setup follows: a layout, a colour theme, a wallpaper, optional apps (VS Code and others download on Wi-Fi), fast mode and the keyboard. At the end, “Show Me” opens a browser, a terminal and Files side by side.

The LinPad boot screen: an ASCII penguin, a progress bar and Starting Linux
Every later launch: the boot screen, with the performance mode it is starting in. Current development build in the iPad simulator.

From then on, LinPad opens on its boot screen and goes straight to your desktop, with the windows you had open.

Updates and your files

Next: turn on fast mode. Developers can also build LinPad from source.