--- description: Build and sign a Cordova iOS app in the cloud without a Mac. Use Capawesome Cloud Native Builds to produce a signed .ipa from Windows or Linux in minutes. title: How to Build a Cordova iOS App Without a Mac - Capawesome image: https://capawesome.io/docs/assets/images/social/blog/build-cordova-ios-app-without-a-mac.png --- [ Skip to content](#how-to-build-a-cordova-ios-app-without-a-mac) [ πŸ” Introducing the **Capacitor Vault** plugin β€” store secrets behind biometrics or a device passcode.](/blog/announcing-the-capacitor-vault-plugin/) * [ SDKs ](/docs/sdks/) * [ Formbricks ](/docs/sdks/capacitor/formbricks/) * [ Geocoder ](/docs/sdks/capacitor/geocoder/) * [ Google Sign-In ](/docs/sdks/capacitor/google-sign-in/) * [ Grafana Faro ](/docs/sdks/capacitor/grafana-faro/) * [ libSQL ](/docs/sdks/capacitor/libsql/) * [ Live Update ](/docs/sdks/capacitor/live-update/) * [ Managed Configurations ](/docs/sdks/capacitor/managed-configurations/) * [ Media Session ](/docs/sdks/capacitor/media-session/) * [ ML Kit ](/docs/sdks/capacitor/mlkit/) * [ Navigation Bar ](/docs/sdks/capacitor/navigation-bar/) * [ NFC ](/docs/sdks/capacitor/nfc/) * [ OAuth ](/docs/sdks/capacitor/oauth/) * [ Pedometer ](/docs/sdks/capacitor/pedometer/) * [ Photo Editor ](/docs/sdks/capacitor/photo-editor/) * [ PostHog ](/docs/sdks/capacitor/posthog/) * [ Printer ](/docs/sdks/capacitor/printer/) * [ Purchases ](/docs/sdks/capacitor/purchases/) * [ RealtimeKit ](/docs/sdks/capacitor/realtimekit/) * [ Screen Orientation ](/docs/sdks/capacitor/screen-orientation/) * [ Screenshot ](/docs/sdks/capacitor/screenshot/) * [ Secure Preferences ](/docs/sdks/capacitor/secure-preferences/) * [ Speech Recognition ](/docs/sdks/capacitor/speech-recognition/) * [ Speech Synthesis ](/docs/sdks/capacitor/speech-synthesis/) * [ Share Target ](/docs/sdks/capacitor/share-target/) * [ Square Mobile Payments ](/docs/sdks/capacitor/square-mobile-payments/) * [ SQLite ](/docs/sdks/capacitor/sqlite/) * [ Superwall ](/docs/sdks/capacitor/superwall/) * [ Torch ](/docs/sdks/capacitor/torch/) * [ Vault ](/docs/sdks/capacitor/vault/) * [ Wifi ](/docs/sdks/capacitor/wifi/) * [ Zip ](/docs/sdks/capacitor/zip/) * [ Cordova ](/docs/sdks/cordova/) * [ Cloud ](/docs/cloud/) * [ Integrations ](/docs/cloud/live-updates/integrations/) * Concepts * Reference * [ Troubleshooting ](/docs/cloud/live-updates/troubleshooting/) * [ FAQ ](/docs/cloud/live-updates/faq/) * [ Native Builds ](/docs/cloud/native-builds/) * [ Set Up Environments ](/docs/cloud/native-builds/environments/) * [ Overwrite Native Configurations ](/docs/cloud/native-builds/native-configurations/) * [ Auto-Increment Build Numbers ](/docs/cloud/native-builds/auto-incrementing-build-numbers/) * [ Configure the Web Build Script ](/docs/cloud/native-builds/web-build-script/) * [ Build from a Monorepo ](/docs/cloud/native-builds/monorepo/) * [ Use pnpm or Yarn ](/docs/cloud/native-builds/package-managers/) * [ Install Private npm Packages ](/docs/cloud/native-builds/npm-private-registry/) * [ Override the Java Version ](/docs/cloud/native-builds/override-java-version/) * [ Custom iOS Provisioning Profiles ](/docs/cloud/native-builds/custom-ios-provisioning-profiles/) * [ Build without Git ](/docs/cloud/native-builds/build-without-git/) * [ Access Git Behind a Firewall ](/docs/cloud/native-builds/firewall-access/) * [ Integrations ](/docs/cloud/native-builds/integrations/) * Reference * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ FAQ ](/docs/cloud/native-builds/faq/) * [ App Store Publishing ](/docs/cloud/app-store-publishing/) * [ Submit a Build ](/docs/cloud/app-store-publishing/submit-a-build/) * [ Submit Automatically After a Build ](/docs/cloud/app-store-publishing/submit-automatically/) * [ Troubleshooting ](/docs/cloud/app-store-publishing/troubleshooting/) * [ FAQ ](/docs/cloud/app-store-publishing/faq/) * [ Automations ](/docs/cloud/automations/) * [ Reference ](/docs/cloud/automations/reference/) * [ Troubleshooting ](/docs/cloud/automations/troubleshooting/) * [ FAQ ](/docs/cloud/automations/faq/) * [ Assist ](/docs/cloud/assist/) * [ CLI ](/docs/cloud/cli/) * APIs and SDKs * [ Webhooks ](/docs/cloud/webhooks/) * [ Integrations ](/docs/cloud/integrations/) * Account * [ Organization ](/docs/cloud/organizations/) * [ Two-Factor Enforcement ](/docs/cloud/organizations/two-factor-authentication/) * [ Audit Logs ](/docs/cloud/organizations/audit-logs/) * [ Billing ](/docs/cloud/organizations/billing/) * [ License Keys ](/docs/cloud/license-keys/) * [ AI ](/docs/ai/) * [ Insiders ](/docs/insiders/) * [ Billing & Plans ](/docs/insiders/billing-and-plans/) * [ FAQ ](/docs/insiders/faq/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/support/) * [ Contributing ](/docs/contributing/) * Contributing code * [ Code of Conduct ](/docs/contributing/code-of-conduct/) * [ Questions ](https://docs.github.com/en/discussions/collaborating-with-your-community-using-discussions/participating-in-a-discussion#creating-a-discussion) * [ Blog ](/blog/) * Categories * [ What about config.xml and the build environment? ](#what-about-configxml-and-the-build-environment) * [ Get Started ](#get-started) * [ Conclusion ](#conclusion) # How to Build a Cordova iOS App Without a Mac[ΒΆ](#how-to-build-a-cordova-ios-app-without-a-mac "Permanent link") You can build a Cordova iOS app without owning a Mac by running the build on a hosted macOS machine in the cloud. The catch every Cordova developer on Windows or Linux runs into is that `cordova build ios` needs Xcode, and Xcode only runs on macOS. The good news is that the Mac can live in a data center instead of on your desk. This is a hands-on walkthrough. By the end you'll have connected a Cordova project to a cloud build service, uploaded your signing certificate, and pulled down a signed `.ipa`, all without a Mac in the room. [ ![Build and deploy your Cordova app with Capawesome Cloud](../../assets/external/cloud.capawesome.io/assets/banners/cloud-build-and-deploy-capacitor-apps.69628c3f.png) ](https://capawesome.io/) ## Key Takeaways[ΒΆ](#key-takeaways "Permanent link") * Building a Cordova iOS app requires macOS, because Apple's toolchain (Xcode, `xcodebuild`, `codesign`) is macOS-only. * You don't have to own a Mac. [Capawesome Cloud](https://capawesome.io) builds Cordova apps on hosted Apple Silicon (M4) macOS instances and works from Windows, Linux, or macOS. * To produce a signed build, you upload an iOS distribution certificate (a `.p12` with its private key) and a matching provisioning profile once. * A single command, `apps:builds:create --platform ios`, returns a signed `.ipa`. iOS build types cover simulator, development, ad-hoc, app-store, and enterprise. * There's no build YAML to write. Cordova projects are detected automatically, and signing credentials are injected at build time. ## Why does building a Cordova iOS app need a Mac?[ΒΆ](#why-does-building-a-cordova-ios-app-need-a-mac "Permanent link") Apple's iOS build toolchain runs only on macOS. Xcode, `xcodebuild`, and `codesign` have no Linux or Windows equivalent, and there's no supported way to produce a real `.ipa` outside an Apple-controlled environment. When you run `cordova build ios`, Cordova generates an Xcode project and then hands off to that toolchain, so the final packaging and signing step always happens on a Mac. That leaves three ways to get one: buy a Mac, rent a remote Mac by the hour, or use a mobile CI/CD service that gives you a managed macOS build on demand. Each trades cost against how much of the macOS box you have to manage yourself. We compared all three in [How to Build and Deploy iOS Apps Without Owning a Mac](/blog/how-to-build-and-deploy-ios-apps-without-a-mac/), so this post skips the comparison and goes straight to the managed-build approach for a Cordova project. ## What you need before you start[ΒΆ](#what-you-need-before-you-start "Permanent link") Before triggering a cloud build, get three things in order. You'll need a Cordova app in a Git repository, an [Apple Developer Program](https://developer.apple.com/programs/) membership, and the signing assets that Apple requires for any installable iOS build. For a signed build, that means an iOS distribution certificate exported as a `.p12` file that includes its private key, the password you set when exporting it, and a provisioning profile whose bundle identifier matches your app. If wrangling certificates in Keychain Access isn't appealing, the [iOS Certificate Generator](https://capawesome.io/tools/ios-certificate-generator/) creates a valid `.p12` for you. A simulator build skips signing entirely, which is useful for a first smoke test. ## Build a Cordova iOS app without a Mac, step by step[ΒΆ](#build-a-cordova-ios-app-without-a-mac-step-by-step "Permanent link") The whole flow is four commands and one credential upload. Here's each step. ### Step 1: Create the app in Capawesome Cloud[ΒΆ](#step-1-create-the-app-in-capawesome-cloud "Permanent link") Start by creating an app and telling the Cloud it's a Cordova project. The CLI prompts for the organization and name, then prints the new app ID: `[](#%5F%5Fcodelineno-0-1)npx @capawesome/cli apps:create --type cordova ` The `--type cordova` flag is what marks the project as Cordova rather than Capacitor or native. Keep the app ID handy for the commands below. ### Step 2: Connect your Git repository[ΒΆ](#step-2-connect-your-git-repository "Permanent link") Cloud builds run from a Git reference, so the next step is linking your repository. Run the link command from inside your project and it detects the provider, owner, and repository name from your `origin` remote: `[](#%5F%5Fcodelineno-1-1)npx @capawesome/cli apps:link --app-id ` Capawesome Cloud connects to GitHub, GitHub Enterprise, GitLab, GitLab Self-Managed, Bitbucket, and Azure DevOps. You can also link the repository from the [Console](https://console.cloud.capawesome.io) if you'd rather authorize the provider through a web flow. ### Step 3: Upload your iOS signing certificate[ΒΆ](#step-3-upload-your-ios-signing-certificate "Permanent link") A signed iOS build needs your distribution certificate and provisioning profile available to the build machine. Upload them once on the [Signing Certificates](https://console.cloud.capawesome.io/apps/%5F/certificates) page: provide the `.p12` file, its password, and the matching `.mobileprovision` profile. They're stored encrypted and injected into the build automatically from then on. The [iOS certificates documentation](/docs/cloud/native-builds/certificates/ios/) covers the details, including apps with extensions that need a separate profile per target. ### Step 4: Trigger a signed build[ΒΆ](#step-4-trigger-a-signed-build "Permanent link") With the repository linked and the certificate uploaded, one command builds and signs the app. This produces an App Store build from the `main` branch and downloads the `.ipa` when it finishes: `[](#%5F%5Fcodelineno-2-1)npx @capawesome/cli apps:builds:create \ [](#%5F%5Fcodelineno-2-2) --platform ios \ [](#%5F%5Fcodelineno-2-3) --type app-store \ [](#%5F%5Fcodelineno-2-4) --certificate "My Distribution Certificate" \ [](#%5F%5Fcodelineno-2-5) --git-ref main \ [](#%5F%5Fcodelineno-2-6) --ipa ` Swap `--type` for `development` or `ad-hoc` depending on where the build is headed, and pass the name of the certificate you uploaded in step 3 to `--certificate`. If you want to test a local change without committing first, replace `--git-ref` with `--path .` to upload your working copy instead. ### Step 5: Get the signed .ipa[ΒΆ](#step-5-get-the-signed-ipa "Permanent link") The `--ipa` flag in the previous command downloads the artifact to your machine as soon as the build completes. If you triggered the build without it, you can pull the artifact from a finished build directly: `[](#%5F%5Fcodelineno-3-1)npx @capawesome/cli apps:builds:download --ipa ./app.ipa ` From the Console, the build's detail page has a **Download** button for the `.ipa` and an **Install App** option that shows a QR code for side-loading onto a registered device. ## What about config.xml and the build environment?[ΒΆ](#what-about-configxml-and-the-build-environment "Permanent link") There's no build configuration file to write. Capawesome Cloud detects a standard Cordova project from its `config.xml` and `platforms` layout, installs dependencies, and runs the build. Native Builds works with Capacitor, Cordova, and plain native projects without per-framework setup. Two things are worth knowing. If your Cordova app lives in a subdirectory of a monorepo, add a `capawesome.config.json` at the repository root with a `baseDir` pointing at it, and optionally a `webBuildCommand` for your web build. And if you need a specific Xcode version, the build runs on a selectable macOS stack (Sequoia or Tahoe), each with a recent Xcode preinstalled, chosen with the `--stack` flag. The full set of options lives in the [Native Builds configuration](/docs/cloud/native-builds/configuration/) docs. Android works the same way. Run the build with `--platform android` and provide an Android keystore instead of a `.p12`, and you get a signed `.aab` or `.apk` from the same pipeline. ## Get Started[ΒΆ](#get-started "Permanent link") Building a Cordova iOS app without a Mac comes down to creating an app, linking your repo, uploading a certificate, and running one build command. The [Native Builds setup guide](/docs/cloud/native-builds/setup/) walks through the full pipeline, and once you have a signed App Store build, [App Store Publishing](/docs/cloud/app-store-publishing/) can push it straight to TestFlight. [Try Capawesome Cloud Free](https://capawesome.io) ## Conclusion[ΒΆ](#conclusion "Permanent link") A Cordova iOS build needs macOS, but it no longer needs _your_ macOS. Hand the Xcode and signing work to a hosted Mac, keep writing your app on Windows or Linux, and let a single CLI command return the signed `.ipa`. The one thing a cloud build can't do is replace a local simulator for interactive debugging, so a borrowed or rented Mac still helps there. If you're weighing the wider picture of where Cordova CI/CD is heading now that App Center is gone and Appflow is winding down, read [The Modern CI/CD Solution for Cordova Apps in 2026](/blog/ci-cd-for-cordova-apps/). Stuck on a certificate or a build error? Ask in the [Capawesome Discord server](https://discord.gg/VCXxSVjefW), and subscribe to the [Capawesome newsletter](https://capawesome.io/newsletter/) to follow what's next for Cordova on Capawesome Cloud. June 10, 2026 Back to top