{"id":16641933,"url":"https://github.com/ptr1337/arm-img-builder-docker","last_synced_at":"2025-12-24T09:24:03.644Z","repository":{"id":54056551,"uuid":"318000804","full_name":"ptr1337/arm-img-builder-docker","owner":"ptr1337","description":"Building customized arm images with docker","archived":false,"fork":false,"pushed_at":"2022-06-01T11:40:47.000Z","size":131,"stargazers_count":7,"open_issues_count":1,"forks_count":1,"subscribers_count":2,"default_branch":"main","last_synced_at":"2025-01-18T15:53:11.271Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://wiki.arm-image-builder.xyz/Docker","language":"Dockerfile","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/ptr1337.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2020-12-02T21:50:33.000Z","updated_at":"2023-06-15T18:42:57.000Z","dependencies_parsed_at":"2022-08-13T06:20:40.287Z","dependency_job_id":null,"html_url":"https://github.com/ptr1337/arm-img-builder-docker","commit_stats":null,"previous_names":[],"tags_count":1,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptr1337%2Farm-img-builder-docker","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptr1337%2Farm-img-builder-docker/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptr1337%2Farm-img-builder-docker/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/ptr1337%2Farm-img-builder-docker/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/ptr1337","download_url":"https://codeload.github.com/ptr1337/arm-img-builder-docker/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243165082,"owners_count":20246719,"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":[],"created_at":"2024-10-12T07:48:18.113Z","updated_at":"2025-12-24T09:24:03.607Z","avatar_url":"https://github.com/ptr1337.png","language":"Dockerfile","funding_links":[],"categories":[],"sub_categories":[],"readme":"\u003cimg src=\"https://socialify.git.ci/ptTrR/arm-img-builder-docker/image?description=1\u0026descriptionEditable=Build%20customized%20arm%20images%20with%20docker\u0026font=Bitter\u0026forks=1\u0026issues=1\u0026logo=https%3A%2F%2Fwww.docker.com%2Fsites%2Fdefault%2Ffiles%2Fd8%2F2019-07%2Fvertical-logo-monochromatic.png\u0026owner=1\u0026pattern=Charlie%20Brown\u0026pulls=1\u0026stargazers=1\u0026theme=Dark\" alt=\"arm-img-builder-docker\" width=\"640\" height=\"320\" /\u003e\n\n## Docker arm image builder\n\nFor easily build your image we have created a docker image. The only thing you need to install is docker and docker-compose.\nYou have the possibility to build the docker image yourself or download the image from docker hub.\nThe prebuilt docker images are available for the following architectures:\n\n* amd64\n* arm64\n\nHere you find the image on the docker-hub:\n\n[pttrr/arm-img-builder](https://hub.docker.com/r/pttrr/arm-img-builder)\n\nWe will provide two different tags: \n\n\u003e amd64 --\u003e for cross compiling on amd64 \n\n\u003e arm64 --\u003e for native compiling or cross compiling on arm64\n\n### Installing docker and docker-compose\n\nDocker and docker-compose are for following operating systems available:\n\n* Linux (all distros)\n* Mac\n* Windows\n\nYou will find how to install docker and docker-compose for your operating system here:\n\nhttps://docs.docker.com/get-docker/\n\n### Install docker at raspberry or other arm devices\n\nThe official instruction for installing docker-compose on arm devices isnt working sometimes. \n\nYou can follow this guide for the installation:\nhttps://dev.to/rohansawant/installing-docker-and-docker-compose-on-the-raspberry-pi-in-5-simple-steps-3mgl\n\n### Torubleshooting if building the image is failing\nIf you got some problems at using for compiling the image or the docker container you should install the following on your host system:\n\n```\nsudo apt install qemu-user-static binfmt-support #debian/ubuntu\n\nsudo pacman -S qemu-arch-extra #arch(aur must be maybe enabled)\n\nif there are still problems run the follwing command:\n\ndocker run --rm --privileged multiarch/qemu-user-static --reset -p yes\n```\n## Usage\n\n### Clone my repo\n\n```\ngit clone https://github.com/ptr1337/arm-img-builder-docker\n```\nor create the docker-compose.yml:\n\n```\nversion: '3.6'\nservices:\n\n  arm-img-builder:\n#    build: .  #uncomment for building \n    image: pttrr/arm-img-builder:amd64 #crosscompiling on x64\n#    image: pttrr/arm-img-builder:arm64 #native or crosscompiling on a arm64\n    privileged: true\n    container_name: arm-img-builder\n    stdin_open: true\n    tty: true\n#    restart: always\n    volumes:\n      - /sys/fs/cgroup:/sys/fs/cgroup:ro\n      - /dev:/dev\n      - ./:/images\n```\n#### Change the image tag to your needs. \n\n**:amd64 is for cross compiling on x86_64 Machine\n:arm64 for compiling on a arm64 machine **\n\n### Pulling and start the container\n\n```\ndocker-compose pull \u0026\u0026 docker-compose up -d\n```\nIf your container is successfully started you have to exec into it:\n```\ndocker exec -it arm-img-builder bash\n```\n### Docker-Addon\n\nWe also created a \"docker-helper\" which is aimed for guys which not using docker that often or never used it. \nJust check this link:\n\nhttps://wiki.arm-image-builder.xyz/en/docker-addon\n\n### Supported Builder\n\n* [rpi-img-builder](https://github.com/pyavitz/rpi-img-builder) is located at /build/rpi-img-builder\n* [debian-image-builder](https://github.com/pyavitz/debian-image-builder) is located at /build/debian-img-builder\n\n## Usage inside the container\n\nJust run in the /build dir following commands (mostly they should do the commands if enterying the container but for going sure):\n\n```\nmake update # Updating scripts and the makefile\n```\nThen enter in your wanted builder directory and follow the commands which you will find here:\n\n[raspberry-image-builder](https://wiki.arm-image-builder.xyz/en/Raspberry)\n[debian-image-builder](https://wiki.arm-image-builder.xyz/en/Debian)\n\n## Moving image to the host system\nWhen your image built, you just have to move your to the /image directory, for example:\n```\nmv *.img.xz /images\n```\n\nThen you will find the image where you started the docker-compose. \n\n## Maintenance and Troubleshooting\n\n### Cleanup\n\nFor clearing up your directory and built cache in the container you can use the following commands:\n\n```\nmake cleanup\nmake purge\nmake purge-all\n```\n### Clearing the complete docker system\n\n1. Stop your running container with `docker stop arm-img-builder` \n2. Then run `docker system prune -a --volumes`\n\n## Support\n\nFor more information watch at our [Wiki](https://wiki.arm-image-builder.xyz/) or [GitHub](https://github.com/pyavitz).\n\nShould you come across any bugs, feel free to either open an issue on GitHub or talk with us directly by joining our channel on Freenode; [`#debianarm-port`](irc://irc.freenode.net/#debianarm-port)\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fptr1337%2Farm-img-builder-docker","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fptr1337%2Farm-img-builder-docker","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fptr1337%2Farm-img-builder-docker/lists"}