Wie du deine eigene AltStore- oder SideStore-Quelle erstellst

VonScarlet iOS Team Aktualisiert am

Eine AltStore- oder SideStore-Source ist der Link, über den deine Apps in diesen Stores auftauchen. Diese Anleitung zeigt, wie du eine Source auf Basis von AltStores eigener Entwicklerdokumentation erstellst, der auch SideStore folgt. Zuletzt geprüft: 28. Oktober 2026, anhand der AltStore-Seiten Make a Source, Updating Apps, Distribute with AltStore Classic und AltSource CLI sowie der SideStore-Seite App Sources.

Die Risiken zuerst

  • Eine Source listet nur Apps auf. Installiert werden die IPA-Dateien, auf die sie verlinkt, also liste nur Apps auf, die du selbst erstellt hast oder weitergeben darfst. Fremde kostenpflichtige Apps erneut hochzuladen ist eine Urheberrechtsverletzung.
  • Wer deine JSON-Datei oder deine Download-Links bearbeiten kann, kann ändern, was deine Nutzer installieren. Verwende für den Hoster ein Konto mit Zwei-Faktor-Authentifizierung und verlinke keine IPA-Dateien auf Servern, die du nicht selbst kontrollierst.
  • Deine Nutzer installieren weiterhin mit ihrer eigenen Apple ID, daher gelten für sie die Grenzen des kostenlosen Accounts: 3 Apps gleichzeitig und eine 7-tägige Signatur.
  • AltStore prüft die Berechtigungen. Laut Dokumentation „verweigert es die Installation jeder App, deren Berechtigungen nicht mit denen der Source übereinstimmen“, ein unvollständiger Eintrag macht die Installation also kaputt.

Was eine Source ist

Laut AltStore-Dokumentation ist eine Source „einfach eine selbst gehostete JSON-Datei mit grundlegenden Metadaten zu deinen Apps“. Du legst die Datei auf einem beliebigen Webhost ab, der sie unter einer stabilen HTTPS-URL ausliefert, stellst deine IPA-Dateien daneben online und teilst die URL. Mehrere Sources in unserer Liste von AltStore- und SideStore-Sources werden über GitHub Pages oder als Rohdatei in einem GitHub-Repository gehostet.

Auf der SideStore-Seite App Sources heißt es, SideStore sei „vollständig kompatibel mit AltStore Sources (oder AltSources)“, und verweist für das Format auf die AltStore-Dokumentation. Eine Source-Datei deckt also beide Stores ab, solange du sie für AltStore Classic baust (siehe PAL-Hinweis unten).

Das ist keine sources.list-Datei. Dieses Format ist für Jailbreak-Paketmanager wie Cydia und Sileo gedacht und funktioniert weder in AltStore noch in SideStore.

Die minimale Source-Datei

In der Dokumentation von AltStore sind die Schlüssel auf Source-Ebene, die nicht als optional markiert sind, name, nsfw, apps und news. Hier ist ein kleines funktionierendes Layout für eine App, erstellt aus den Beispielen in der AltStore-Dokumentation:

{
  "name": "My Example Source",
  "subtitle": "A source for all of my apps",
  "iconURL": "https://example.com/source_icon.png",
  "website": "https://example.com",
  "nsfw": false,
  "apps": [
    {
      "name": "My Example App",
      "bundleIdentifier": "com.example.myapp",
      "developerName": "Example Developer",
      "localizedDescription": "What the app does.",
      "iconURL": "https://example.com/myapp_icon.png",
      "versions": [
        {
          "version": "1.0",
          "buildVersion": "1",
          "date": "2026-10-28",
          "downloadURL": "https://example.com/myapp-1.0.ipa",
          "size": 79821,
          "minOSVersion": "14.0"
        }
      ],
      "appPermissions": {
        "entitlements": [],
        "privacy": {}
      }
    }
  ],
  "news": []
}

Die wichtigsten Keys

Key Was die Dokumentation von AltStore dazu sagt
bundleIdentifier Muss genau mit dem CFBundleIdentifier in der Info.plist der App übereinstimmen und ist case-sensitive. Eine Source darf nicht zwei Apps mit derselben ID auflisten.
version und buildVersion Müssen mit CFBundleShortVersionString und CFBundleVersion in der Info.plist übereinstimmen.
downloadURL Bei AltStore Classic die URL der hochgeladenen .ipa-Datei.
size Die App-Größe in Bytes, die den Nutzern auf der Store-Seite angezeigt wird.
date Das Veröffentlichungsdatum im ISO-8601-Format, zum Beispiel 2026-10-28.
minOSVersion / maxOSVersion Optional. AltStore blendet Updates aus, die das Gerät nicht ausführen kann. Die Dokumentation weist darauf hin, dass die meisten Apps kein Maximum festlegen sollten.
appPermissions Jede Berechtigung (Entitlement) und jeder „UsageDescription“-Privacy-Key in der App. AltStore vergleicht sie mit der heruntergeladenen IPA.
marketplaceID Nur für notarisierte AltStore-PAL-Apps. Für AltStore Classic nicht erforderlich.
category Optional. Eine von developer, entertainment, games, lifestyle, other, photo-video, social oder utilities.

Um die Info.plist-Werte aus einer selbst erstellten IPA auszulesen, benenne eine Kopie in .zip um, öffne Payload/YourApp.app/Info.plist und kopiere die drei oben genannten Werte. Falls du die IPA selbst noch brauchst, findest du hier, wie du deine eigene IPA-Datei aus jeder App erstellst.

Schritt für Schritt

  1. Baue deine App und exportiere die .ipa-Datei.
  2. Lade die .ipa auf ein Hosting hoch, das du selbst kontrollierst, und kopiere die direkte Download-URL.
  3. Schreibe die JSON-Datei oder lade dir für AltStore Classic die Beispiel-Source von AltStore auf der Seite „Make a Source“ herunter und bearbeite sie.
  4. Trage die Info.plist-Werte, die Größe in Bytes und die vollständige Liste der Berechtigungen ein.
  5. Lade die JSON-Datei hoch und öffne ihre URL im Browser, um zu prüfen, ob sie als reines JSON geladen wird.
  6. Füge die URL in AltStore oder SideStore hinzu und teste eine Installation auf einem echten Gerät, bevor du den Link teilst.

Tools, die das für dich ausfüllen

  • altsource (AltServer für macOS). Laut der AltStore-Dokumentation enthält AltServer für macOS ein Beta-Kommandozeilen-Tool unter AltServer.app/Contents/MacOS/altsource. altsource new --ipa erstellt eine Source aus einer IPA, und altsource update fügt eine App oder eine neue Version hinzu.
  • AltPublisher. In der AltStore-Dokumentation wird es als „von der Community entwickeltes Tool“ zum Erstellen einer Source erwähnt.
  • AltStudio und AltSource Browser. In der SideStore-Dokumentation werden diese Community-Tools aufgeführt. Dort wird gewarnt, dass du nach dem Erstellen einer Source mit AltStudio die automatisch generierten Felder marketplaceID und Build entfernen musst, „andernfalls geht SideStore davon aus, dass es sich um eine notariell beglaubigte Source handelt, und verhindert, dass deine Source hinzugefügt wird“.

Community-Tools werden nicht von AltStore oder SideStore entwickelt. Prüfe das von ihnen erzeugte JSON, bevor du es veröffentlichst.

Updates veröffentlichen

Um eine neue Version bereitzustellen, lade die neue IPA hoch und füge einen neuen Eintrag am Anfang der versions-Liste der App hinzu. Auf der Updating-Apps-Seite von AltStore heißt es, dass der erste Eintrag mit der installierten Version verglichen wird und „keine Daten verwendet werden, um festzustellen, ob eine neuere Version vorliegt“. Jeder Eintrag braucht eine andere version oder buildVersion. Nutzer müssen das Update weiterhin selbst installieren, was unser Guide zum Aktualisieren gesideloadeter Apps behandelt.

Deine Source teilen

Die SideStore-Dokumentation gibt ein Link-Format für das Hinzufügen mit einem Tap an: sidestore://source?url= gefolgt von deiner Source-URL. Dort wird angemerkt, dass der Link abstürzt, wenn SideStore nicht installiert ist, weshalb man Nutzern auch die reine URL zum Einfügen in den Sources-Tab geben sollte.

Ein Hinweis zu AltStore PAL

AltStore PAL, die EU-Version, nutzt notariell beglaubigte Apps im ADP-Format von Apple und benötigt eine marketplaceID sowie eine Manifest-URL anstelle eines einfachen IPA-Links. Dafür braucht man ein registriertes Apple-Entwicklerkonto und Apples Notarisierung, das ist also eine andere Aufgabe als eine Sideloading-Source. SideStore fügt keine notariell beglaubigte Source hinzu. Wenn du IPA-Dateien teilen möchtest, baue für AltStore Classic.

FAQ

Kann ich eine Source auf GitHub hosten?

Ja. Eine Source ist eine statische JSON-Datei. GitHub Pages und rohe Dateien in einem Repository liefern beide diese Datei aus, und mehrere öffentliche Sources funktionieren auf diese Weise.

Warum weigert sich AltStore, eine App aus meiner Quelle zu installieren?

Die häufigste Ursache laut Dokumentation ist eine falsche Berechtigungszuordnung: Die appPermissions-Liste muss jede Entitlement- und Datenschutz-Angabe enthalten, die die IPA nutzt. Ein falscher bundleIdentifier oder eine falsche Versionsangabe verursacht ebenfalls Probleme.

Warum sehen meine Nutzer das Update nicht?

Wahrscheinlich steht die neue Version nicht an erster Stelle in der versions-Liste, sie hat dieselbe Versions- und Build-Nummer wie die alte, oder ihre minOSVersion liegt höher als die iOS-Version der Nutzer.

Kann Scarlet meine AltStore-Quelle nutzen?

Scarlet verwendet ein eigenes Repository-Format und signiert Apps mit einem gemeinsam genutzten Enterprise-Zertifikat, es handelt sich also um ein separates System. Sieh dir dazu unseren Leitfaden IPA-Bibliotheken und Repositories an. Scarlet ist bestätigt für iOS 14 bis iOS 26 nutzbar; Unterstützung für iOS 27 wird von Dritten berichtet, ist aber nicht offiziell bestätigt.

Ähnliche Beiträge