{"id":13647386,"url":"https://github.com/advancedtelematic/meta-updater","last_synced_at":"2025-12-28T02:39:16.099Z","repository":{"id":47348774,"uuid":"74472222","full_name":"advancedtelematic/meta-updater","owner":"advancedtelematic","description":"OTA Software updates using OSTree ","archived":false,"fork":false,"pushed_at":"2023-06-02T07:18:56.000Z","size":2706,"stargazers_count":161,"open_issues_count":7,"forks_count":61,"subscribers_count":25,"default_branch":"master","last_synced_at":"2024-11-04T18:27:53.711Z","etag":null,"topics":["embedded","linux","ostree","ota","yocto"],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/advancedtelematic.png","metadata":{"files":{"readme":"README.adoc","changelog":null,"contributing":"CONTRIBUTING.adoc","funding":null,"license":"COPYING.MIT","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null}},"created_at":"2016-11-22T12:53:34.000Z","updated_at":"2024-10-13T01:11:34.000Z","dependencies_parsed_at":"2023-10-20T16:22:01.098Z","dependency_job_id":null,"html_url":"https://github.com/advancedtelematic/meta-updater","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advancedtelematic%2Fmeta-updater","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advancedtelematic%2Fmeta-updater/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advancedtelematic%2Fmeta-updater/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/advancedtelematic%2Fmeta-updater/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/advancedtelematic","download_url":"https://codeload.github.com/advancedtelematic/meta-updater/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":250163659,"owners_count":21385282,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["embedded","linux","ostree","ota","yocto"],"created_at":"2024-08-02T01:03:32.084Z","updated_at":"2025-12-28T02:39:16.016Z","avatar_url":"https://github.com/advancedtelematic.png","language":"Python","funding_links":[],"categories":["Python"],"sub_categories":[],"readme":"= meta-updater\n:toc: macro\n:toc-title:\n:devguide-docsroot: https://docs.ota.here.com/ota-client/latest/\n:getstarted-docsroot: https://docs.ota.here.com/getstarted/dev/\n\nMeta-updater is a link:https://www.yoctoproject.org/software-overview/layers/[Yocto layer] that enables over-the-air updates (OTA) with https://github.com/ostreedev/ostree[OSTree] and https://github.com/advancedtelematic/aktualizr[Aktualizr] -- the default client for link:https://www.here.com/products/automotive/ota-technology[HERE OTA Connect].\n\nhttps://github.com/ostreedev/ostree[OSTree] is a tool for atomic full file system upgrades with rollback capability. OSTree has several advantages over traditional dual-bank systems, but the most important one is that it minimizes network bandwidth and data storage footprint by sharing files with the same contents across file system deployments.\n\nhttps://github.com/advancedtelematic/aktualizr[Aktualizr] implements https://uptane.github.io/uptane-standard/uptane-standard.html[Uptane], supports device authentication and provisioning, and is integrated with OSTree. You can connect aktualizr to your own server solution or sign up for a free account at https://connect.ota.here.com/[HERE OTA Connect] to get started.\n\n== Quickstart\n\nIf you don't already have a Yocto project that you want to add OTA to, you can use the xref:{getstarted-docsroot}get-started.html[HERE OTA Connect Quickstart] project to rapidly get up and running on a xref:{getstarted-docsroot}raspberry-pi.html[Raspberry Pi] or with xref:{getstarted-docsroot}qemuvirtualbox.html[QEMU]. It takes a standard https://www.yoctoproject.org/tools-resources/projects/poky[poky] distribution, and adds OTA and OSTree capabilities.\n\n== Dependencies\n\nIn addition to the link:https://www.yoctoproject.org/docs/current/ref-manual/ref-manual.html#required-packages-for-the-build-host[standard Yocto dependencies], meta-updater generally requires a few additional dependencies, depending on your use case and target platform. To install these additional packages on Debian/Ubuntu, run this:\n\n....\nsudo apt install cpu-checker default-jre parted\n....\n\nTo build for https://github.com/advancedtelematic/meta-updater-minnowboard[Minnowboard] with GRUB, you will also need to install https://github.com/tianocore/tianocore.github.io/wiki/OVMF[TianoCore's ovmf] package on your host system. On Debian/Ubuntu, you can do so with this command:\n\n....\nsudo apt install ovmf\n....\n\n[discrete]\n== Table of Contents\n\nThe following documentation focuses on tasks that involve the meta-updater layer. If you want to get an idea of the overall developer workflow in OTA Connect, see the link:{devguide-docsroot}index.html[OTA Connect Developer Guide].\n\n* xref:{devguide-docsroot}supported-boards.html[Supported boards]\n+\nFind out if your board is supported and learn about the minimum hardware requirements.\n+\n* xref:{devguide-docsroot}build-agl.html[Build an Automotive Grade Linux image]\n+\nLearn how to use this layer as part of AGL.\n+\n* xref:{devguide-docsroot}add-ota-functonality-existing-yocto-project.html[Add OTA functionality to an existing Yocto project]\n+\nLearn how to add this layer to your own Yocto project.\n+\n* xref:{devguide-docsroot}build-configuration.html[SOTA-related variables in local.conf]\n+\nLearn how to configure OTA-related functionality when building images, including how to install custom versions of aktualizr.\n+\n* xref:{devguide-docsroot}recommended-clientconfig.html[Recommended configuration]\n+\nLearn how to optimize your build for development or production.\n+\n* xref:{devguide-docsroot}client-provisioning-methods.html[Provisoning methods]\n+\nLearn more about the methods for provisioning devices. For more detail, you may also want to read about how to xref:{devguide-docsroot}enable-device-cred-provisioning.html[enable device credential provisioning] or how to xref:{devguide-docsroot}simulate-device-cred-provtest.html[simulate it for testing].\n+\n* xref:{devguide-docsroot}meta-updater-usage.html[Advanced usage]\n+\nLearn about the `garage-push` and `garage-sign` utilities, aktualizr configuration recipes, and service resource control.\n+\n* xref:{devguide-docsroot}meta-updater-testing.html[Testing with oe-selftest and ptest]\n+\nLearn how to use the `oe-selftest` framework for quality assurance and how to run the aktualizr test suite via ptest.\n+\n* xref:{devguide-docsroot}troubleshooting.html[Troubleshooting]\n+\nGet help on common problems.\n\n== License\n\nThis code is licensed under the link:COPYING.MIT[MIT license], a copy of which can be found in this repository. All code is copyright HERE Europe B.V., 2016-2020.\n\nWe require that contributors accept the terms of Linux Foundation's link:https://developercertificate.org/[Developer Certificate of Origin]. Please see the https://github.com/advancedtelematic/aktualizr/blob/master/CONTRIBUTING.md[contribution instructions of aktualizr] for more information.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadvancedtelematic%2Fmeta-updater","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fadvancedtelematic%2Fmeta-updater","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fadvancedtelematic%2Fmeta-updater/lists"}