Knowledge Base
Short, practical guides for getting builds onto your testers’ phones — from your first upload to automating the whole thing from CI.
Start here
1Uploading your first buildDrop in an .apk or .ipa and get a share link in seconds. What gets read out of the binary, and where the build lands.2Set up CI uploadsCreate a token, add one step to your pipeline, and every build your CI produces gets a share link. Start here, whichever CI you use.3Inviting testersAdd a tester by email, what they see next, and how email and push notifications fire when a new build lands.
Getting started· 1 guide
CI/CD & automation· 8 guides
Set up CI uploadsCreate a token, add one step to your pipeline, and every build your CI produces gets a share link. Start here, whichever CI you use.Uploading from GitHub ActionsOne step in your workflow uploads the build — and posts the install link and QR code straight onto the pull request.Uploading from FastlaneInstall the plugin, add one line to your lane. A near drop-in swap if you're piping ad-hoc builds into Diawi today.Uploading from CodemagicOne script step in codemagic.yaml or the workflow editor, for Flutter, React Native and native builds.Uploading from BitriseAdd a Script step after your build step, wire up the secret, and every Bitrise build reaches your testers.Uploading from CircleCIAdd a run step to your job, with the token in a project variable or a shared org context.CLI referenceEvery command, flag, environment variable and exit code for the appdropper npm package.API referenceAuthentication, endpoints, the three-step upload flow, error codes and rate limits — what the CLI and the plugins are built on.
Sharing & testers· 5 guides
Share links and expiryPublic, password-protected and invite-only links, how long a build stays alive, and how to buy it more time.Inviting testersAdd a tester by email, what they see next, and how email and push notifications fire when a new build lands.iOS UDIDs for ad-hoc buildsWhy an ad-hoc .ipa only installs on registered devices, how App Dropper shows you which ones, and what to do when an install fails.Extending and deleting buildsPush a build's expiry back, pin one so it never expires, restore one that just lapsed — and what the free plan's 5-build limit does.Password-protecting a linkLighter than full invites: put a password on a project's public link so only people who have it can view or install.