Ionic Deploy is a tool that enables you and your team to send live code changes directly to your users, when you’re ready, without waiting in line for App Store reviews and approvals.
This article covers the following questions:
- What is the definition of a "Live Update"?
- Do downloads from the app store count against the live deploy limit?
- What happens when live deploys are depleted for the month?
What is the definition of a "live update"?
A live update is a single commit (or "Deploy build") that is applied to a single physical device via Ionic Deploy. Whether a live update is applied to your app or not depends on:
- The Channel specified in the Deploy setup (see your config.xml or package.json file)
- The native versioning setup for the Deploy build
- This is not the same as your app's binary version number, but native versioning does relate to your binary
Note: Incrementing your app's binary version number does not guarantee that app will stop receiving live updates from Deploy.
How are live updates counted?
If you send one update to 200 devices, that counts as 200 live updates. If you send two updates to 200 devices, that counts as 400 Live Deploys. The Deploy limits associated with each plan are monthly. Your quota will refresh at the beginning of each calendar month. If you exceed your quota for a given month, you will have to upgrade to a higher plan, or wait until the next calendar month to send more updates. If you need more than 50,000 Live Deploys (our highest self-service plan limit associated with the Business tier), contact our sales team for an Enterprise plan that will scale to meet your needs.
Do downloads from the app store count against the live deploy limit?
Ionic Pro and the Deploy service (and our Deploy Limits) never limit or change how often you can manually update the App Stores with new native binaries. We don’t handle or limit this process for you, and you can do it unlimited times.
However, you’ll want to make sure that new installs from the App Store don’t automatically download Deploys from us. In order to do this, make sure when you upload a new native binary to the App Stores that you set the “Equivalent” native versioning to the native version you deployed to the app store for iOS and Android. You can do this by clicking on the build hash in your dashboard and clicking on the “Native Versioning” tab.
If you do NOT set up Equivalent native versioning, whenever someone downloads your app from the App Store, if you have an active commit on the Channel that app is pulling from, it WILL count as a Live Update because an update is being downloaded from our server.
What happens when live deploys are depleted for the month?
First of all, it’s important to note that your quota is for a Calendar month (January, February, etc) and not your billing period.
When you use all of your live update quota for the month, users will no longer be able to download new versions of your app to their devices. This means if you run out in the middle of an update, half of your users might wind up on an older version of your code if you don’t have any quota left. Users left on older versions of your code will still function correctly on that version of code.
When limits start to be enforced during the month of April 2018, you will receive three emails from Ionic about your Deploy Limits:
- An email when you hit 70% of your quota
- An email when you hit your quota telling you to upgrade
- A final email warning you that we’re going to turn off your Deploy service until the next billing cycle if you haven’t upgraded your Ionic Pro plan after a grace period of live update usage.
When the 1st of the next month rolls around, you’ll be able to use Deploy again, and live update rollouts that didn’t finish will continue to rollout to users that didn’t receive the update.