gramX
gramX home

Install gramX on iPhone

gramX isn't in the App Store. On iPhone, you install it with a free helper app and your own Apple Account. It takes about 20 minutes the first time, and you need a computer for part of it. Each step shows the screen you'll see; tap a picture to make it bigger.

Open this page on your computer and your iPhone. You'll go back and forth between them.

Before you start

gramX needs a refresh once a week. Apple lets apps installed this way run for 7 days at a time. Refreshing takes a few seconds, and the steps below show how. If the week runs out, gramX won't open until you refresh it, but nothing is lost and you stay signed in.

Three apps at most. A free Apple Account can have three apps installed this way at once. SideStore and AltStore count as one of them.

Choose a helper app

All three are free and do the same job. If you're not sure, choose Sideloadly.

Sideloadly Simplest Everything happens on the computer. You plug in your iPhone once a week to refresh. SideStore After setup, you refresh on the iPhone itself, so you rarely need the computer. AltStore Refreshes by itself while your iPhone is on the same Wi-Fi as your computer.

Install with Sideloadly

On your computer

  1. Windows only: install iTunes and iCloud from Apple's website. Sideloadly needs them to talk to your iPhone. Use the links on Sideloadly's website. The versions from the Microsoft Store don't work, so if you have those, uninstall them first.

    Download buttons for iTunes and iCloud from Apple’s website, not the Microsoft Store.

  2. Install Sideloadly from sideloadly.io, its only official website.

    The download buttons on sideloadly.io.

  3. Download gramX to the computer. It's one file, ending in .ipa.

    Download gramX for iPhone

    24 MB · iOS 15 or newer

    The browser’s downloads list showing the gramX file, finished.

  4. Connect your iPhone to the computer with the cable, and unlock it. If the iPhone asks Trust This Computer?, tap Trust and enter your passcode.

    The iPhone asks whether to trust this computer.

  5. Open Sideloadly. Drag the gramX file onto the IPA icon. Check that your iPhone is selected, and type your Apple Account email in the box for it.

    Sideloadly with the gramX file dropped on the IPA box, your iPhone selected, and your Apple Account typed in.

  6. Click Advanced options and tick Use automatic bundle ID, if it isn't ticked already. Then click Start.

    Sideloadly’s advanced options, with Use automatic bundle ID ticked, and the Start button.

  7. Sign in when asked. Enter your Apple Account password, then the verification code that appears on your other Apple devices or arrives by text. Wait until Sideloadly says it's done.

    Sideloadly asks for your Apple Account password, then for the verification code.

On your iPhone

  1. Trust your Apple Account. Open Settings›General›VPN & Device Management. Under Developer App, tap your email, tap Trust, then tap Trust again.

    Settings: the page for your Apple Account, with its Trust button and the confirmation.

  2. Turn on Developer Mode (iOS 16 and newer). Open Settings›Privacy & Security›Developer Mode, near the bottom. Turn it on and tap Restart. When the iPhone is back on, tap Turn On and enter your passcode.

    Settings: Developer Mode switched on, and the prompt to restart.

  3. Open gramX. Sign in with your Telegram phone number, or browse public channels as a guest.

    The gramX welcome screen: continue with a phone number, log in via QR code, or browse without an account.

Every week

Plug your iPhone into the computer, open Sideloadly, and click Start again with the same gramX file and Apple Account. gramX runs for another 7 days, and you stay signed in. Sideloadly can also refresh by itself while the computer is on; you'll find automatic refreshing in its settings.

Install with SideStore

On your iPhone

  1. Get LocalDevVPN from the App Store. Open it, tap Connect, and allow it to add a VPN configuration. SideStore needs it switched on whenever it installs or refreshes an app.

    LocalDevVPN with its Connect button, and the iPhone asking to allow a VPN configuration.

On your computer

  1. Windows only: install iTunes from Apple's website. It lets the computer talk to your iPhone. The version from the Microsoft Store doesn't work.

    The download button for iTunes from Apple’s website, not the Microsoft Store.

  2. Install iloader from iloader.app. It's the tool that puts SideStore on your iPhone.

    The download buttons on iloader.app, for Windows and for Mac.

  3. Connect your iPhone to the computer with the cable, and unlock it. If the iPhone asks Trust This Computer?, tap Trust and enter your passcode.

    The iPhone asks whether to trust this computer.

  4. Open iloader and sign in with your Apple Account email and password, then the verification code Apple sends you.

    iloader’s Apple ID panel with the Sign In button, and the verification code prompt.

  5. Select your iPhone, then click SideStore (Stable). Wait until iloader says SideStore Installed!

    iloader with your iPhone selected, the SideStore (Stable) button, and the message that SideStore was installed.

Back on your iPhone

  1. Trust your Apple Account. Open Settings›General›VPN & Device Management. Under Developer App, tap your email, tap Trust, then tap Trust again.

    Settings: the page for your Apple Account, with its Trust button and the confirmation.

  2. Turn on Developer Mode (iOS 16 and newer). Open Settings›Privacy & Security›Developer Mode, near the bottom. Turn it on and tap Restart. When the iPhone is back on, tap Turn On and enter your passcode.

    Settings: Developer Mode switched on, and the prompt to restart.

  3. Finish setting up SideStore. Open LocalDevVPN and tap Connect. Open SideStore and sign in with the same Apple Account. Go to My Apps and tap the 7 DAYS button next to SideStore. If it asks, tap Yes or Refresh Now.

    SideStore’s My Apps tab, with the 7 DAYS button next to SideStore.

  4. Download gramX in Safari. If you opened this page from Telegram or another app, open it in Safari first. When Safari asks, tap Download. The file goes to Downloads in the Files app.

    Download gramX for iPhone

    24 MB · iOS 15 or newer

    Safari asks whether to download the gramX file.

  5. Install gramX. With LocalDevVPN connected, open SideStore, go to My Apps, and tap + at the top. Choose the gramX file from Downloads and wait for it to install.

    SideStore’s My Apps tab with the plus button at the top, and the gramX file chosen from Downloads.

  6. Open gramX. Sign in with your Telegram phone number, or browse public channels as a guest.

    The gramX welcome screen: continue with a phone number, log in via QR code, or browse without an account.

Every week

Open LocalDevVPN and tap Connect. Then open SideStore, go to My Apps and tap Refresh All. That refreshes SideStore and gramX together. If SideStore itself runs out, it won't open either: plug into the computer and install it with iloader again, as above.

Install with AltStore

On your computer

  1. Windows only: install iTunes and iCloud from Apple's website. AltServer needs them to talk to your iPhone. Use the links in AltStore's Windows guide. The versions from the Microsoft Store don't work.

    Download buttons for iTunes and iCloud from Apple’s website, not the Microsoft Store.

  2. Install AltServer from altstore.io; you want AltStore Classic. On a Mac, move AltServer to Applications and open it; its icon appears in the menu bar. On Windows, run Setup, then find AltServer in the Start menu, right-click it and choose Run as administrator; its icon appears near the clock.

    The AltServer download buttons on altstore.io, and where its icon appears once it runs.

  3. Connect your iPhone to the computer with the cable, and unlock it. If the iPhone asks Trust This Computer?, tap Trust and enter your passcode.

    The iPhone asks whether to trust this computer.

  4. Turn on Wi-Fi sync, so AltStore can refresh without the cable later. On a Mac, select your iPhone in Finder and tick Show this iPhone when on Wi-Fi. On Windows, open iTunes, select your iPhone and tick Sync with this iPhone over Wi-Fi. Click Apply.

    The Wi-Fi sync box: Show this iPhone when on Wi-Fi in Finder on a Mac, or Sync with this iPhone over Wi-Fi in iTunes on Windows.

  5. Click the AltServer icon, choose Install AltStore, then your iPhone. Enter your Apple Account email and password. On a Mac, if it asks you to install the Mail plug-in, follow AltStore's steps for that and try again. Wait until AltServer says AltStore was installed.

    The AltServer menu with Install AltStore open and your iPhone listed, and the Apple ID sign-in it shows next.

On your iPhone

  1. Trust your Apple Account. Open Settings›General›VPN & Device Management. Under Developer App, tap your email, tap Trust, then tap Trust again.

    Settings: the page for your Apple Account, with its Trust button and the confirmation.

  2. Turn on Developer Mode (iOS 16 and newer). Open Settings›Privacy & Security›Developer Mode, near the bottom. Turn it on and tap Restart. When the iPhone is back on, tap Turn On and enter your passcode.

    Settings: Developer Mode switched on, and the prompt to restart.

  3. Download gramX in Safari. If you opened this page from Telegram or another app, open it in Safari first. When Safari asks, tap Download. The file goes to Downloads in the Files app.

    Download gramX for iPhone

    24 MB · iOS 15 or newer

    Safari asks whether to download the gramX file.

  4. Install gramX. Make sure AltServer is running on the computer and both are on the same Wi-Fi. Open AltStore, go to My Apps, and tap + at the top. Choose the gramX file from Downloads. If AltStore asks you to sign in, use the same Apple Account.

    AltStore’s My Apps tab with the plus button at the top, and the gramX file chosen from Downloads.

  5. Open gramX. Sign in with your Telegram phone number, or browse public channels as a guest.

    The gramX welcome screen: continue with a phone number, log in via QR code, or browse without an account.

Every week

AltStore refreshes gramX on its own whenever your iPhone is on the same Wi-Fi as the computer and AltServer is running, so it helps to have AltServer open when the computer starts. To refresh by hand, open AltStore, go to My Apps and tap Refresh All.

Updating gramX

New versions are listed on the Releases page. Download the new file and install it the same way as the first time, with the same helper app and Apple Account. It replaces the old version, and you stay signed in.

Want to check a download? Every release lists its files in SHA256SUMS.txt.

If something goes wrong

gramX won't open, or closes right away

If it worked before, its 7 days have most likely run out. Refresh it with your helper app, as in the Every week box above. Don't delete gramX: that would remove its data and sign you out.

If it has never opened, check the two iPhone steps: trusting your Apple Account, and turning on Developer Mode.

I can't find Developer Mode

It's only on iOS 16 and newer, and it appears once an app has been installed with your Apple Account. Finish the computer steps first, then look again under Settings, Privacy & Security, near the bottom. On iOS 15 there's nothing to turn on, so skip that step.

It says I've reached a limit

A free Apple Account can have three apps installed this way at once, counting SideStore or AltStore. Remove one you don't need and try again.

It can also add no more than ten new apps a week. If that's the limit you hit, wait a few days and try again.

Is it safe to enter my Apple Account password?

The helper app sends it to Apple, to get the 7-day permission that lets gramX run on your iPhone. gramX itself never sees it.

If you'd rather keep your main account out of it, create a separate free Apple Account and use it only in the helper app. Your iPhone can stay signed in to your usual one.

Does the weekly refresh affect my Telegram account?

No. It only decides whether the app opens. Your messages and channels are on Telegram, and the copy gramX keeps on your iPhone stays through every refresh.

Is the iPhone version different from Android?

One thing is missing: on iPhone, gramX doesn't appear when you tap Share in other apps. The rest of the app is the same.

Still stuck? Report a problem and say which helper app you used and what it showed.