# Upload Your First Build

> Upload your first App Build to Applivery step by step — from the Dashboard, via API, or CI/CD integration.

Source: https://docs.applivery.com/en/app-distribution/getting-started/upload-first-build/  •  Last updated: 2026-03-30

**Key topics:** Applivery build upload, Mobile app distribution, Build processing states, Applivery, iOS, Android, IPA, APK, AAB, Bitrise.io, Fastlane, Windows, macOS

---

**TL;DR:** Learn how to upload your first mobile app build to Applivery through a simple step-by-step process.

If you have already [created your first app](https://docs.applivery.com/en/app-distribution/getting-started/create-first-app/), now it’s time to upload your first Build. There are several ways to do it, including automatic ones using our API or 3rd party platforms such as Bitrise.io or Fastlane that allows to automatically deploy your Apps into Applivery in a seamless and effortless way.

Since it’s your first time, let’s keep it simple!

**Go to your Applications**

From the **Apps** section, click the **App** where you want to upload a Build to.

![Apps section](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/0e20f8ac-ba6c-48e4-bce5-6d0d65dcbb03.png)

**Upload your Build**

You will be redirected to the list of Builds (probably empty right now). Now, click the **\+ Upload Build** button.  

![upload build](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/ef6457f8-3a2d-426e-b91c-7fbbe8014ce0.png)

Click in the greyed area to browse your hard disk and find the package you want to upload that must have one of the following file extensions:

-   `.ipa` for iOS and iPadOS.
    
-   `.pkg` or `.dmg` for macOS.
    
-   `.apk` or `.aab` for Android.
    
-   `.msi`, `.exe`, `.msix`, `.appx`, `.msixbundle` or `.appxbundle` for Windows.
    
-   `.zip` or `.tar.gz` formats are supported across all platforms.
    

:::info
These are the default file extensions you can upload to your Workspace. You can read more about **Custom Build Platforms** [here](https://docs.applivery.com/en/app-distribution/platforms/custom-platforms/).
:::

![upload build form](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/aa1ad383-6ee6-4d6b-aefb-64fc15f626f4.png)

The modal view will automatically change to allow you to select some additional settings, such as the name of the Build, add some tags, add a changelog, or configure the notification settings.

Once you are ready to proceed, click the **Upload** button to start the upload process.  

![upload build](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/d328085b-61ab-4e20-82a5-84b1a7e0f8df.png)

Once it finishes uploading your Build, you will be back to the list of Builds, and you should find a new row with one of the following states:

-   **Queued:** The Build is waiting to be processed by our systems.
    
-   **Processing:** The package is being processed by our systems.
    
-   **Failed:** The package has been analyzed, but we were not able to get any information out of it. You can read more about the Build processing error codes [here](https://docs.applivery.com/en/app-distribution/builds/processing-error-codes/).
    
-   **Finished:** The Build has been successfully processed. You will see the App icon (if any) and additional information.
    

Please be patient since it might take a while, depending on the size of your Builds.

![build state](https://docs.applivery.com/int/_r2/media/09ac0a4e-3ad8-478f-9f15-3474973eec71/fbd89c68-2a97-40a7-bf15-ad988581cb07.png)