{"id":37607830,"url":"https://github.com/offspot/base-image","last_synced_at":"2026-01-16T10:14:01.697Z","repository":{"id":38301141,"uuid":"421696657","full_name":"offspot/base-image","owner":"offspot","description":"Kiwix-BSF Hotspot Base Image","archived":false,"fork":false,"pushed_at":"2025-11-17T12:32:12.000Z","size":1286,"stargazers_count":3,"open_issues_count":3,"forks_count":2,"subscribers_count":6,"default_branch":"main","last_synced_at":"2025-11-17T14:31:04.012Z","etag":null,"topics":["kiwix","library","offline","olip","raspberry-pi"],"latest_commit_sha":null,"homepage":"https://drive.offspot.it/base/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"gpl-3.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/offspot.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":".github/FUNDING.yml","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},"funding":{"github":["kiwix","bibliosansfrontieres"],"patreon":null,"open_collective":null,"ko_fi":null,"tidelift":null,"community_bridge":null,"liberapay":null,"issuehunt":null,"otechie":null,"custom":null}},"created_at":"2021-10-27T06:08:01.000Z","updated_at":"2025-11-17T12:32:16.000Z","dependencies_parsed_at":"2023-01-22T02:52:03.646Z","dependency_job_id":"a22952d5-bea9-4556-8dcc-b9a1efbd0b9a","html_url":"https://github.com/offspot/base-image","commit_stats":null,"previous_names":[],"tags_count":8,"template":false,"template_full_name":null,"purl":"pkg:github/offspot/base-image","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offspot%2Fbase-image","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offspot%2Fbase-image/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offspot%2Fbase-image/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offspot%2Fbase-image/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/offspot","download_url":"https://codeload.github.com/offspot/base-image/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/offspot%2Fbase-image/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":28478049,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-01-16T06:30:42.265Z","status":"ssl_error","status_checked_at":"2026-01-16T06:30:16.248Z","response_time":107,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"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":["kiwix","library","offline","olip","raspberry-pi"],"created_at":"2026-01-16T10:14:01.557Z","updated_at":"2026-01-16T10:14:01.660Z","avatar_url":"https://github.com/offspot.png","language":"Python","funding_links":["https://github.com/sponsors/kiwix","https://github.com/sponsors/bibliosansfrontieres"],"categories":[],"sub_categories":[],"readme":"# base-image\n\nA raspiOS-like image to use as *master* for both Kiwix Offspot and OLIP through the use of [`image-creator`](https://github.com/offspot/image-creator).\n\n[![release](https://img.shields.io/github/v/tag/offspot/base-image?label=latest%20release\u0026sort=semver)](https://drive.offspot.it/base/)\n[![CodeFactor](https://www.codefactor.io/repository/github/offspot/base-image/badge)](https://www.codefactor.io/repository/github/offspot/base-image)\n[![Build Status](https://github.com/offspot/base-image/actions/workflows/build-and-upload.yml/badge.svg?branch=main)](https://github.com/offspot/base-image/actions/workflows/build-and-upload.yml?query=branch%3Amain)\n[![License: GPL v3](https://img.shields.io/badge/License-GPLv3-blue.svg)](https://www.gnu.org/licenses/gpl-3.0)\n\n\n## Scope\n\nThis produces a raspiOS-like image that will, in a compatible device:\n\n- Setup a (configurable) WiFi Access Point\n- Setup ethernet networking (accoding to configuration)\n- Setup a docker-compose project\n\nOur **target is all Raspberry Pi 3 models and newer**. Currently: `3A+`, `3B`, `3B+`, `4B`, `400`, `Zero 2 W`.\n\n## Usage\n\nRequirements: **docker**, **python3**. It is possible to build the image without docker (`--no-docker`) but requires specific host system and requirements (see pi-gen)\n\n```\n./builder.py --help\n```\n\n## Testing Images\n\nReleases are available from https://drive.offspot.it/base/. Test builds are uploades to S3. Links are available in the run's details.\n\nRegular tests can be done via [dockerpi](/lukechilds/dockerpi)\n\n```sh\ndocker run -it -v $(pwd)/offspot-base.img:/sdcard/filesystem.img lukechilds/dockerpi pi3\n```\n\nDon't validate an image without testing on actual hardware by [flashing the Image on a microSD card](https://github.com/raspberrypi/rpi-imager).\n\n## Troubleshooting\n\nThis tool mainly prepares a pi-gen custom build so checking the [troubleshooting](https://github.com/RPi-Distro/pi-gen/blob/master/README.md#troubleshooting) section there should be a first in case of any trouble. You should also be familiar with its [README](https://github.com/RPi-Distro/pi-gen/blob/master/README.md).\n\n## Using non-standard hardware\n\nWe only provide support for our fixed targets list and scenarios. That said, it's a raspiOS system so you should be able to adapt it easily.\n\n- Pi Compute Module matching a supported Model with WiFi should work directly.\n- No WiFi scenario is not supported. You'll need to tweak the runtime-config script so it doesn't start `hostapd`.\n- Using additional WiFi interfaces is possible (as client or as AP). If chipset is not supported, its driver must be installed.\n- Non-arm would require tweaking the tree and the script to use regular debian sources instead of raspbian.\n- 32b ARM (Pi 0/1/2) can work. Use the `--arch=armhf` flag of the builder. In the running system, remove docker and its source-list then reinstall it from raspbian repo.\n\n```sh\napt-get remove docker-ce docker-ce-cli containerd.io docker-compose-plugin runc\nrm /etc/apt/sources.list.d/docker.list\napt-get update\napt-get install docker.io docker-compose\n```\n\nPlease, [Open a ticket](https://github.com/offspot/base-image/issues/new) explaining what you're trying to achieve and why. We may be able to provide directions. ","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foffspot%2Fbase-image","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Foffspot%2Fbase-image","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Foffspot%2Fbase-image/lists"}