# Distribute with AltStore PAL

Distributing your app with AltStore PAL is similar to what you may be used to when submitting to the Apple App Store. You will still submit apps through App Store Connect using your paid Apple Developer account, so make sure you are set up with one before proceeding. The only major difference is that your apps will only be available in the EU.

{% hint style="info" %}
You **do not** have to be located in or have a business in the EU to distribute your apps with AltStore PAL.
{% endhint %}

When ready, follow each of the steps outlined below to begin distributing your apps on AltStore PAL 🙂

<details>

<summary>Agree to Alternative EU Terms Addendum</summary>

The Alternative EU Terms Addendum is an additional agreement you must make with Apple in order to distribute your apps outside the App Store.&#x20;

Request EU Terms Addendum: <https://developer.apple.com/contact/request/alternative-eu-terms-addendum/>

**Note:** The new terms will change your commission rates and fees for apps distributed in the EU. [Learn More](https://developer.apple.com/support/core-technology-fee/)

</details>

<details>

<summary>Add AltStore PAL as an alternative marketplace</summary>

Before you can submit your apps to AltStore PAL, you must prepare your developer account for distribution with alternative marketplaces

1. Register your Developer ID with AltStore PAL using our [REST API](https://faq.altstore.io/developers/rest-api). You can find your Developer ID in App Store Connect by selecting "Edit Profile" in the top right.

   <figure><img src="https://2606795771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAfe8qEztjcTjsjjaMBY2%2Fuploads%2FLM7aPLlSMNEs38FsTuDT%2FDevIDAppConnect(Hidden).jpg?alt=media&#x26;token=a5474802-ef47-461e-b56c-61e407107205" alt=""><figcaption></figcaption></figure>
2. You will receive a response with a security token. In App Store Connect, go to Users and Access -> Integrations -> Marketplace, click '+' and input the token.

   <figure><img src="https://2606795771-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FAfe8qEztjcTjsjjaMBY2%2Fuploads%2F3DKiHuyiTkPapqo0t9ZE%2Fmarketplace.PNG?alt=media&#x26;token=6744414c-0f89-458f-b34b-9525642ca0b2" alt=""><figcaption></figcaption></figure>
3. Select the app(s) you want to distribute with AltStore PAL. You can change this at any time.
4. Select "Yes, send notifications" on the next screen to let AltStore PAL process your apps automatically (recommended).

**All apps must be processed by AltStore PAL before they can be distributed.** If you don't want AltStore PAL to process your builds automatically, you can manually process them using our [REST API](https://faq.altstore.io/developers/rest-api).

</details>

<details>

<summary>Submit your app(s) for Notarization</summary>

Even though you are distributing outside the App Store, you still need to submit your app(s) to Apple for Notarization before they can be distributed. This is similar to Apple's App Store review process but fewer guidelines. For more detailed instructions, see Apple's [Notarization](https://developer.apple.com/help/app-store-connect/distributing-apps-in-the-european-union/submit-for-notarization) support page.

1. Select your app in App Store Connect
2. In the App Review section, click Edit under "Review Type".
3. Select "Notarization" as the review type and click Save.
4. Submit app(s) for review.

**If you still plan to distribute your app through the Apple App Store, you can skip this step.** Your apps will be automatically notarized when approved for the App Store.

</details>

<details>

<summary>Host your Alternative Distribution Package (ADP)</summary>

Once Notarized, you'll need to download your app's ADP to then host it on your server.

1. Download your ADP using our [REST API](https://faq.altstore.io/rest-api#download-adp).
2. Upload the complete package to your server. You must preserve the directory hierarchy exactly, and the hashes of each file must not change. In other words, **DO NOT modify the `manifest.json` in any way (e.g prettifying).**

</details>

<details>

<summary>Create a source</summary>

Once your server is updated with your app's ADP, the last step is to [make a source](https://faq.altstore.io/developers/make-a-source), which is just a JSON file with information about your app(s).

Once you've uploaded your source, it will be made available on PAL and anyone can now add the URL to download your apps! **(Requires AltStore PAL 2.2 or later)**

</details>

<details>

<summary>Make your source discoverable (Optional) </summary>

You can optionally make your source discoverable, which means your apps and updates will appear automatically on our [website](https://explore.alt.store/) where anyone can easily find them.

1. Add the [`fediUsername`](https://faq.altstore.io/make-a-source#fediusername-string) key to your source
2. Federate your source using our [REST API](https://faq.altstore.io/rest-api#federate-source)

</details>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://faq.altstore.io/developers/distribute-with-altstore-pal.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.
