--- description: Use GitLab CI/CD to build your web assets and create bundles on Capawesome Cloud using the Capawesome CLI. title: Integrate Capawesome Cloud with GitLab CI/CD - Capawesome image: https://capawesome.io/docs/assets/images/social/cloud/live-updates/integrations/gitlab-ci.png --- [ Skip to content](#gitlab-cicd) [ 🎉 Introducing **Capawesome Platform** — one platform for Live Updates, Native Builds, App Store Publishing, and Insider SDKs.](https://capawesome.io) * [ Formbricks ](/docs/plugins/formbricks/) * [ Geocoder ](/docs/plugins/geocoder/) * [ Google Sign-In ](/docs/plugins/google-sign-in/) * [ libSQL ](/docs/plugins/libsql/) * [ Live Update ](/docs/plugins/live-update/) * [ Managed Configurations ](/docs/plugins/managed-configurations/) * [ Media Session ](/docs/plugins/media-session/) * [ ML Kit ](/docs/plugins/mlkit/) * [ NFC ](/docs/plugins/nfc/) * [ OAuth ](/docs/plugins/oauth/) * [ Pedometer ](/docs/plugins/pedometer/) * [ Photo Editor ](/docs/plugins/photo-editor/) * [ PostHog ](/docs/plugins/posthog/) * [ Printer ](/docs/plugins/printer/) * [ Purchases ](/docs/plugins/purchases/) * [ RealtimeKit ](/docs/plugins/realtimekit/) * [ Screen Orientation ](/docs/plugins/screen-orientation/) * [ Screenshot ](/docs/plugins/screenshot/) * [ Secure Preferences ](/docs/plugins/secure-preferences/) * [ Speech Recognition ](/docs/plugins/speech-recognition/) * [ Speech Synthesis ](/docs/plugins/speech-synthesis/) * [ Share Target ](/docs/plugins/share-target/) * [ Square Mobile Payments ](/docs/plugins/square-mobile-payments/) * [ SQLite ](/docs/plugins/sqlite/) * [ Superwall ](/docs/plugins/superwall/) * [ Torch ](/docs/plugins/torch/) * [ Wifi ](/docs/plugins/wifi/) * [ Zip ](/docs/plugins/zip/) * [ Cloud ](/docs/cloud/) * [ Live Updates ](/docs/cloud/live-updates/) * Advanced * Integrations * [ Pipeline ](#pipeline) * [ Native Builds ](/docs/cloud/native-builds/) * [ Configuration ](/docs/cloud/native-builds/configuration/) * [ Environments ](/docs/cloud/native-builds/environments/) * Guides * [ Sample Projects ](/docs/cloud/native-builds/sample-projects/) * [ Troubleshooting ](/docs/cloud/native-builds/troubleshooting/) * [ Automations ](/docs/cloud/automations/) * [ Assist ](/docs/cloud/assist/) * Account * Organizations * [ Organization and User Management ](/docs/cloud/organizations/memberships/) * [ Single Sign-On (SSO) ](/docs/cloud/organizations/sso/) * [ Teams ](/docs/cloud/organizations/teams/) * [ Two-Factor Authentication ](/docs/cloud/organizations/two-factor-authentication/) * [ Integrations ](/docs/cloud/integrations/) * [ License Keys ](/docs/cloud/license-keys/) * [ Webhooks ](/docs/cloud/webhooks/) * [ Pricing ](https://capawesome.io/pricing/) * [ FAQ ](/docs/cloud/faq/) * [ Support ](/docs/cloud/support/) * [ Contributing ](/docs/contributing/) * [ LLMs ](/docs/llms/) * [ Insiders ](/docs/insiders/) * [ License ](https://capawesome.io/legal/eula/) * [ Support ](/docs/insiders/support/) * [ FAQ ](/docs/insiders/faq/) * [ Blog ](/blog/) * Categories * [ Pipeline ](#pipeline) # GitLab CI/CD[¶](#gitlab-cicd "Permanent link") You can easily publish Live Updates to Capawesome Cloud using [GitLab CI/CD](https://docs.gitlab.com/ci/). In this guide, we will show you how to create a GitLab CI/CD pipeline that builds your web assets and creates a bundle on Capawesome Cloud using the [Capawesome CLI](/docs/cloud/cli/). ## Preparation[¶](#preparation "Permanent link") Before you start, make sure you have a Capawesome Cloud account and an app set up. Next, you need to create a Capawesome Cloud token and add it to your GitLab project as a CI/CD variable. ### Create a Capawesome Cloud token[¶](#create-a-capawesome-cloud-token "Permanent link") Create a new Capawesome Cloud token via the [Capawesome Cloud Console](https://console.cloud.capawesome.io/settings/tokens). Just navigate to the `Tokens` page in the settings and click on the `Create Token` button. Choose a name for the token and click on the `Create` button. The token is now copied to your clipboard. ### Create a GitLab CI/CD Variable[¶](#create-a-gitlab-cicd-variable "Permanent link") Add the Capawesome Cloud token to your GitLab project as a CI/CD variable with the name `CAPAWESOME_CLOUD_TOKEN` as described in [CI/CD variables](https://docs.gitlab.com/ci/variables/). Make sure to mark the variable as masked and protected. ## Pipeline[¶](#pipeline "Permanent link") ### Create the Pipeline[¶](#create-the-pipeline "Permanent link") Create a new GitLab CI/CD pipeline file in your repository under `.gitlab-ci.yml` with the following content: `[](#%5F%5Fcodelineno-0-1)spec: [](#%5F%5Fcodelineno-0-2) inputs: [](#%5F%5Fcodelineno-0-3) channel: [](#%5F%5Fcodelineno-0-4) description: The name of the channel to deploy the update to. [](#%5F%5Fcodelineno-0-5) default: production [](#%5F%5Fcodelineno-0-6)--- [](#%5F%5Fcodelineno-0-7)stages: [](#%5F%5Fcodelineno-0-8) - deploy [](#%5F%5Fcodelineno-0-9) [](#%5F%5Fcodelineno-0-10)deploy-live-update: [](#%5F%5Fcodelineno-0-11) stage: deploy [](#%5F%5Fcodelineno-0-12) image: node:20 [](#%5F%5Fcodelineno-0-13) before_script: [](#%5F%5Fcodelineno-0-14) - npm ci [](#%5F%5Fcodelineno-0-15) - npm run build [](#%5F%5Fcodelineno-0-16) - npm install -g @capawesome/cli@latest [](#%5F%5Fcodelineno-0-17) script: [](#%5F%5Fcodelineno-0-18) - npx @capawesome/cli apps:channels:create --app-id 00000000-0000-0000-0000-000000000000 --name $[[ inputs.channel ]] --ignore-errors [](#%5F%5Fcodelineno-0-19) - npx @capawesome/cli apps:liveupdates:upload --app-id 00000000-0000-0000-0000-000000000000 --path dist --channel $[[ inputs.channel ]] ` This pipeline will build your web assets, log in to Capawesome Cloud (using the `CAPAWESOME_CLOUD_TOKEN` environment variable), create a channel (if it does not exist yet), and create a bundle for the specified channel. ### Trigger the Pipeline[¶](#trigger-the-pipeline "Permanent link") You can run the pipeline manually by navigating to the `CI/CD` \> `Pipelines` section in your GitLab project and clicking on the `Run pipeline` button. You will be prompted to enter the channel name as a variable. Of course, you can also trigger the pipeline automatically by using different rules like `push` or `merge_request`. January 24, 2026 Back to top