{"id":13720914,"url":"https://github.com/embeddedcontainers/zephyr","last_synced_at":"2025-05-07T13:30:58.765Z","repository":{"id":212817993,"uuid":"731819034","full_name":"embeddedcontainers/zephyr","owner":"embeddedcontainers","description":"Performance-optimized container images for building Zephyr RTOS applications.","archived":false,"fork":false,"pushed_at":"2023-12-17T00:15:51.000Z","size":7,"stargazers_count":29,"open_issues_count":1,"forks_count":1,"subscribers_count":3,"default_branch":"main","last_synced_at":"2024-05-23T01:30:42.590Z","etag":null,"topics":["docker","docker-image","dockerfile","embedded","embedded-c","embedded-systems","oci","oci-image","rtos","zephyr-rtos"],"latest_commit_sha":null,"homepage":"","language":"Dockerfile","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/embeddedcontainers.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-12-15T00:36:57.000Z","updated_at":"2024-08-03T01:26:22.765Z","dependencies_parsed_at":"2023-12-16T15:06:30.436Z","dependency_job_id":"2d4dd22d-0e31-4bab-9bdb-fe235d520092","html_url":"https://github.com/embeddedcontainers/zephyr","commit_stats":null,"previous_names":["embeddedcontainers/zephyr"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embeddedcontainers%2Fzephyr","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embeddedcontainers%2Fzephyr/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embeddedcontainers%2Fzephyr/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/embeddedcontainers%2Fzephyr/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/embeddedcontainers","download_url":"https://codeload.github.com/embeddedcontainers/zephyr/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":224604611,"owners_count":17339171,"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":["docker","docker-image","dockerfile","embedded","embedded-c","embedded-systems","oci","oci-image","rtos","zephyr-rtos"],"created_at":"2024-08-03T01:01:09.815Z","updated_at":"2024-11-14T10:30:42.446Z","avatar_url":"https://github.com/embeddedcontainers.png","language":"Dockerfile","funding_links":[],"categories":["Tools"],"sub_categories":["Build \u0026 Config"],"readme":"# Zephyr Container Images\n\nDevelop Zephyr applications using OCI-compatible Docker images.\n\nCurrently there are two types of images - a \"base\" image that contains the core dependencies to build a Zephyr application for a target SDK version and ones for a specific target architecture. Most users will generally interact with the architecture-specific images.\n\n# Getting container images\n\n## Prebuilt Images\n\nThe simplest way to start using these container images is with the prebuilt images provided by the project. Images are automatically generated using Github Actions and hosted on the Github Container Registry (GHCR.) GHCR is functionally equivalent to Dockerhub and can be used with standard tools like the Docker CLI.\n\nThe project follows an evergreen strategy, meaning only the latest SDK release is maintained. Older SDKs are still hosted but it is recommended to build images locally in order to guarantee the latest packages and security updates are included.\n\n### Using prebuilt images\n\nThe full list of prebuilt images can be found [here](https://github.com/embeddedcontainers/zephyr/pkgs/container/zephyr/versions?filters%5Bversion_type%5D=tagged).\n\nFor example, the image for the `arm` toolchain can be found [here](https://github.com/embeddedcontainers/zephyr/pkgs/container/zephyr/292819795?tag=arm-0.17.0SDK).\n\nTo install via the Docker CLI:\n\n```\n$ docker pull ghcr.io/embeddedcontainers/zephyr:arm-0.17.0SDK\n```\n\nUse as base image in Dockerfile:\n\n```\nFROM ghcr.io/embeddedcontainers/zephyr:arm-0.17.0SDK\n```\n\n## Build images locally\n\nBuilding images locally ensures you can trust the source of the image, as well as allow you to modify the container image configuration.\n\n### Building with Docker CLI\n\n_Build the base image_\n\n```\ndocker build --build-arg ZEPHYR_SDK_VERSION=0.17.0 -f \"./zephyr-base/Dockerfile\" -t zephyr:base-0.17.0SDK \"./zephyr-base\"\n\n```\n\n_To build an image for Arm Cortex-M targets:_\n\n\n```\ndocker build --build-arg BASE_IMAGE=\"zephyr:base-0.17.0SDK\" --build-arg ZEPHYR_SDK_TOOLCHAINS=\"-t arm-zephyr-eabi\" -f \"./zephyr/Dockerfile\" -t zephyr:arm-0.17.0SDK \"./zephyr\"\n```\n\n_To build an image for multiple toolchains:_\n\n```\ndocker build --build-arg BASE_IMAGE=\"zephyr:base-0.17.0SDK\" --build-arg ZEPHYR_SDK_TOOLCHAINS=\"-t arm-zephyr-eabi -t x86_64-zephyr-elf\" -f \"./zephyr/Dockerfile\" -t zephyr:arm_x86-0.17.0SDK \"./zephyr\"\n```\n\n_There is a different Dockerfile for Posix target like `native_sim`. To build:_\n\n```\ndocker build --build-arg BASE_IMAGE=\"zephyr:base-0.17.0SDK\" -f \"./zephyr-posix/Dockerfile\" -t zephyr:posix-0.17.0SDK \"./zephyr-posix\"\n```\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembeddedcontainers%2Fzephyr","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fembeddedcontainers%2Fzephyr","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fembeddedcontainers%2Fzephyr/lists"}