Your submission was sent successfully! Close

You have successfully unsubscribed! Close

Thank you for signing up for our newsletter!
In these regular emails you will find the latest updates about Ubuntu and upcoming events where you can meet our team.Close

We are changing the way you build snaps from GitHub repos

This article was last updated 3 years ago.


On 11 March 2020 we introduced a new process for building a snap using GitHub repos to snapcraft.io. Here is all you need to know about this update.

What is build.snapcraft.io?

Build.snapcraft.io allows you to automatically build and release snaps from a GitHub repository. This means you can build your snaps for multiple architectures and distros with the tools you already use, and new builds are triggered every time you push updates to your repo. Up until now this tool has lived as a separate service on a separate URL to snapcraft.io; but from now on it will live within snapcraft.io to integrate better with your workflow.

What’s new?

Build.snapcraft.io will cease to exist

In order to simplify how Build is integrated within Snapcraft.io, repos will be added to your snaps from within the individual snap pages. In this way, you can see all the relevant information related to your snap from one place. Build will now be a tab that lists all the latest builds and tells you what repo is linked to your snap. The current way you build will continue to be available for the next few months.

The building process will change

Because we moved Build to be integrated with your snap, the way you go about creating a new snap using GitHub has changed too. Now, to start creating a snap you’ll need to log in to snapcraft.io and register your Snap name first.

To build your snaps:

  1. Log in or register on snapcraft.io by clicking the “Developer Account” link in the top right of the site.
  2. Go to “My Snaps” page and select “Register new name”. Choose a name for your snap.
  3. Click on the “Build with GitHub” button that will appear next to your snap name when you hover.
  4. Select an organisation and a repo that you’d like to build from. This repo must have a snapcraft.yaml file and the name declared on the file must match the name you registered.
  5. Trigger your first build by clicking on “Start building”. Your snap will automatically start building. 
  6. Once your snap has been successfully built and released you can go to the “Releases” tab to see the newly released snap.

Your builds will continue to be triggered automatically

Everything else in regard to how you use Build will continue to be the same: every time you push code to GitHub a new build will be automatically triggered, and once it’s published, it will be automatically released to the latest/edge channel.

What do you need to do now?

If you had previous builds from a GitHub repo, we recommend you edit your GitHub Webhook URL so that your snaps automatically build in the future when you push new code. Follow these steps:

  1. Go to GitHub and open the repo you are using to build your snap
  2. Open settings on that repo, and select the “Webhook” tab on the menu
  3. Click the “Edit” button next to the https://build.snapcraft.io URL
  4. Change the “Payload URL”, to match the “GitHub Webhook” found on the settings page (https://snapcraft.io/<snap_name>/settings) for your snap
  5. Click “Update Webhook” to save the change

Give us your feedback

We would be very happy to hear what you think of the changes we have done to this feature. Share your thoughts or issues on the Snapcraft forum, and we’ll be happy to help.

Ubuntu desktop

Learn how the Ubuntu desktop operating system powers millions of PCs and laptops around the world.

Newsletter signup

Get the latest Ubuntu news and updates in your inbox.

By submitting this form, I confirm that I have read and agree to Canonical's Privacy Policy.

Related posts

Snapcraft 8.0 and the respectable end of core18

‘E’s not pinin’! ‘E’s passed on! This base is no more! He has ceased to be! ‘E’s expired and gone to meet ‘is maker! ‘E’s a stiff! Bereft of life, ‘e rests in...

Craft team welcomes you to another episode of its adventures

Welcome to the second article in the Craft team saga. Previously, on Craft Team, we gave you a brief introduction into the team’s function, we announced our...

Snapcrafters: 2022 wrap-up

This article was written by Merlijn Sebrechts and Dani Llewellyn from the Snapcrafters community. ===== Last year, we officially re-launched the...