{"id":51070668,"url":"https://github.com/themactep/thingino-builder-image","last_synced_at":"2026-06-23T10:01:42.084Z","repository":{"id":365284002,"uuid":"1268621588","full_name":"themactep/thingino-builder-image","owner":"themactep","description":"Podman/Docker image for building Thingino firmware in a standardized and reproducible environment","archived":false,"fork":false,"pushed_at":"2026-06-16T16:30:47.000Z","size":22,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":0,"default_branch":"master","last_synced_at":"2026-06-16T18:26:19.637Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":"https://github.com/themactep/thingino-firmware","language":"Shell","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/themactep.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,"zenodo":null,"notice":null,"maintainers":null,"copyright":null,"agents":null,"dco":null,"cla":null}},"created_at":"2026-06-13T18:43:42.000Z","updated_at":"2026-06-16T16:31:07.000Z","dependencies_parsed_at":null,"dependency_job_id":null,"html_url":"https://github.com/themactep/thingino-builder-image","commit_stats":null,"previous_names":["themactep/thingino-builder-image"],"tags_count":null,"template":false,"template_full_name":null,"purl":"pkg:github/themactep/thingino-builder-image","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themactep%2Fthingino-builder-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themactep%2Fthingino-builder-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themactep%2Fthingino-builder-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themactep%2Fthingino-builder-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/themactep","download_url":"https://codeload.github.com/themactep/thingino-builder-image/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/themactep%2Fthingino-builder-image/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":34684686,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-05-26T15:22:16.424Z","status":"online","status_checked_at":"2026-06-23T02:00:07.161Z","response_time":65,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"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":"2026-06-23T10:01:41.207Z","updated_at":"2026-06-23T10:01:42.079Z","avatar_url":"https://github.com/themactep.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# thingino-builder-image\n\n[![Build and push container image](https://github.com/themactep/thingino-builder-image/actions/workflows/build-and-push.yml/badge.svg)](https://github.com/themactep/thingino-builder-image/actions/workflows/build-and-push.yml)\n\nPodman (and Docker) image for building [Thingino firmware](https://github.com/themactep/thingino-firmware) in a standardized and reproducible environment.\n\nPre-built images are published to the GitHub Container Registry:\n\n- `ghcr.io/themactep/thingino-builder-image:latest`\n\n## Quick start (recommended)\n\n### Podman (preferred on Linux desktops)\n\n```bash\n# 1. Install podman if needed\nsudo apt update \u0026\u0026 sudo apt install podman\n\n# 2. Clone the firmware you want to build\ngit clone --recurse-submodules https://github.com/themactep/thingino-firmware.git ~/thingino-firmware\ncd ~/thingino-firmware\n\n# 3. Create a download cache directory (highly recommended for speed)\nmkdir -p dl\n\n# 4. Run a build inside the hosted container\npodman run --rm -it --userns=keep-id \\\n  -v \"$PWD:/workspace\" \\\n  -v \"$PWD/dl:/home/builder/dl\" \\\n  -w /workspace \\\n  ghcr.io/themactep/thingino-builder-image:latest \\\n  make\n```\n\nThe `--userns=keep-id` flag ensures files written inside the container are owned by your real user on the host.\n\n### Docker\n\n```bash\ndocker run --rm -it --user \"$(id -u):$(id -g)\" \\\n  -v \"$PWD:/workspace\" \\\n  -v \"$PWD/dl:/home/builder/dl\" \\\n  -w /workspace \\\n  ghcr.io/themactep/thingino-builder-image:latest \\\n  make\n```\n\n\u003e Note: Docker user mapping is less seamless than Podman's keep-id. Some git operations or tools that expect a passwd entry may behave slightly differently. Podman is recommended.\n\n## Selecting a camera and other make targets\n\nAll normal make targets and variables work. Example:\n\n```bash\n# Interactive camera selection is handled by the firmware's helper scripts when available\npodman run ... ghcr.io/themactep/thingino-builder-image:latest make\n\n# Or pass CAMERA directly for CI / scripting\npodman run ... -e CAMERA=wyze_cam_v3 make\n```\n\nCommon targets (executed inside the container):\n\n- `make` or `make all` – incremental parallel build\n- `make fast` – clean parallel build\n- `make dev` – serial build with V=1 (easier to debug errors)\n- `make menuconfig`, `make linux-menuconfig`, etc.\n- `make cleanbuild`\n- OTA: `make ota IP=192.168.1.123 CAMERA=...`\n\nSee the firmware repository for the full list of targets and `CAMERA=` values.\n\n## Using the firmware's docker helper scripts (optional)\n\nThe firmware repo contains `docker-build.sh` and `Makefile.docker` that wrap container usage, provide camera pickers (fzf/whiptail), and handle image building locally.\n\nThose scripts currently default to building a local image (often tagged `thingino-builder` or `thingino-builder-image`) from the Dockerfile shipped inside the firmware tree. You can point them at the hosted image by exporting `DOCKER_IMAGE=ghcr.io/themactep/thingino-builder-image` (adjust the scripts or set `CONTAINER_ENGINE` appropriately).\n\nFor the simplest \"just works\" hosted experience, the direct `podman run ...` examples above are sufficient and avoid a full local image rebuild on every machine.\n\n## Using the convenience `run.sh` (from this repository)\n\nIf you cloned the `thingino-builder-image` repository, you can use the small wrapper for a completely transparent experience:\n\n```bash\n./run.sh                 # exactly like running \"make\" inside the container\n./run.sh fast            # exactly like \"make fast\"\n./run.sh dev             # exactly like \"make dev\"\n./run.sh menuconfig      # exactly like \"make menuconfig\"\n./run.sh ota IP=192.168.1.123\n./run.sh bash            # drop into an interactive shell\nCAMERA=wyze_cam_v3 ./run.sh fast     # environment variables are forwarded\n```\n\nThe script will:\n- Detect if you're already inside a firmware checkout.\n- Otherwise maintain a checkout under `./workspace/firmware` (cloned with `--recurse-submodules` if missing).\n- Mount a persistent download cache under `./workspace/dl`.\n- Pass environment variables and all arguments through so usage feels identical to running `make` locally.\n\nThis is mainly useful for quick testing from the builder repo itself. Most day-to-day development is done by cloning `thingino-firmware` and either using its own `docker-build.sh` or the direct `podman run` commands shown above.\n\n## Building the container image locally (for customization or air-gapped)\n\n```bash\n# From inside this (thingino-builder-image) repository\npodman build -t thingino-builder-image:local -f Containerfile .\n\n# Then use your local tag instead of the ghcr reference.\n```\n\nYou can also pass build args to bake a specific UID/GID (mainly useful if not using `--userns=keep-id`):\n\n```bash\npodman build --build-arg USER_ID=$(id -u) --build-arg GROUP_ID=$(id -g) \\\n  -t thingino-builder-image:local -f Containerfile .\n```\n\n## Environment variables\n\n- `BR2_DL_DIR` – location of the Buildroot external downloads cache (mounted to `/home/builder/dl` in the examples).\n- `CAMERA`, `GROUP`, `IP`, etc. – passed straight through to the Thingino Makefile.\n\n## Why a separate builder image?\n\n- Fast onboarding: one `podman run` and you have a known-good toolchain.\n- Reproducible builds across developer machines and CI.\n- The heavy dependency layer (apt packages + base image) is built and cached centrally.\n- The firmware source tree stays on the host and can be any branch or dirty checkout.\n\n## Updating the image\n\n```bash\npodman pull ghcr.io/themactep/thingino-builder-image:latest\n```\n\nThe image is rebuilt automatically by CI on pushes to the main branch of this repository.\n\n## License\n\nContents are MIT licensed (see the thingino project for details).\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthemactep%2Fthingino-builder-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fthemactep%2Fthingino-builder-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fthemactep%2Fthingino-builder-image/lists"}