Upload Your App

Four ways to upload iOS and Android apps to Pgyer, with guidance on when to use each.

Pgyer offers four ways to upload your app: the website, a desktop client, the open API, and a mini program. Pick whichever fits your workflow.

Supported Package Formats

iOS: .ipa
Android: .apk
HarmonyOS: .hap (see HarmonyOS beta distribution)

Installer Size Limit

The maximum size of a single app installer uploaded to Pgyer is 2 GB. Installers larger than 2 GB are not currently supported; reduce the installer size before uploading.

This per-file limit is separate from your account's total storage capacity. A storage package increases account capacity but does not raise the 2 GB limit for a single installer. See Account Center for account storage rules.

Comparing the Upload Methods

Method	When to Use	Entry Point
Website	One-off uploads and manual releases, works in both desktop and mobile browsers	The Publish button on the Pgyer website
Desktop client	Mac users who publish frequently	Desktop client download page
Open API	Hooking uploads into CI/CD or automated release pipelines	Upload API docs
Mini program	Quickly uploading and distributing from a phone	Mini program entry page

Upload via the Website

Before publishing an update, read the account storage and historical-build cleanup rules. Apps share the main account's capacity, including sub-account uploads. When storage is exceeded, the account's selected over-quota policy applies, and historical builds removed by automatic cleanup cannot be recovered. Open Account menu → Usage to review usage, clean up history, or add storage. Website, client, and API uploads follow the same capacity rules. Keep your own backups of installers needed for long-term archives.

Click Publish in the Pgyer top navigation to open the upload page. If you already have an installer (.ipa or .apk), start the upload in either of these ways:

Click Upload Now and pick the file;
Drag the file onto the dashed drop zone.

Fill in the app information as prompted to complete the release.

Mobile browsers support uploading as well — no need to switch to a desktop.

Set App Information

Once the upload finishes you land on the App Information page. Pgyer parses these fields from the installer automatically, and you can edit any of them:

App name
Bundle ID / Package Name
App signing type
App icon
App description (if present in the installer)
App screenshots (if present in the installer)

Confirm everything looks right and click Add App to finish.

Upload via the Desktop Client

Pgyer provides a macOS desktop client for users who publish frequently. Grab the installer from the desktop client download page.

Upload via the Open API

To connect Pgyer to build scripts, CI/CD, or AI assistants, start with Automated App Uploads and CI/CD Integration to choose an API, CLI, plugin, MCP, or Agent Skill integration.

The upload API lets you bake Pgyer into your build scripts or CI/CD pipeline for fully automated releases. See the upload API reference for details.

If you'd rather drop in a ready-made script, see PGYER/upload-app-api-example — a shell wrapper you can run with just an API key and an installer path, and a convenient starting point for Jenkins, GitHub Actions, and similar CI systems.

Upload via the Mini Program

The Pgyer mini program lets you upload and distribute directly from your phone. Scan the QR code or open the mini program entry page.

Create a Placeholder App

If you don't have an installer on hand yet, you can create a blank app as a placeholder. Dashboard V2 does not currently expose this action. Open Legacy Dashboard from the account menu, go to My Apps, and choose Add Blank App, or open the placeholder-app creation page directly.

Blank apps can't be installed — they only exist as placeholders. Upload an installer later to activate the app.

Upload Your App

On this page