{"id":43893166,"url":"https://github.com/skycoin/skybian","last_synced_at":"2026-02-06T17:11:06.703Z","repository":{"id":39713837,"uuid":"209257480","full_name":"skycoin/skybian","owner":"skycoin","description":"Base image for Skywire boards. Available for Orange and Raspberry Pi. ","archived":false,"fork":false,"pushed_at":"2023-02-04T22:58:12.000Z","size":20116,"stargazers_count":16,"open_issues_count":1,"forks_count":16,"subscribers_count":6,"default_branch":"master","last_synced_at":"2026-01-14T14:44:49.603Z","etag":null,"topics":["skybian-image","skywire"],"latest_commit_sha":null,"homepage":"","language":"Shell","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/skycoin.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","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":"2019-09-18T08:27:15.000Z","updated_at":"2022-07-01T11:30:54.000Z","dependencies_parsed_at":"2023-02-18T20:01:08.400Z","dependency_job_id":null,"html_url":"https://github.com/skycoin/skybian","commit_stats":null,"previous_names":["skycoinproject/skybian"],"tags_count":13,"template":false,"template_full_name":null,"purl":"pkg:github/skycoin/skybian","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skycoin%2Fskybian","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skycoin%2Fskybian/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skycoin%2Fskybian/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skycoin%2Fskybian/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/skycoin","download_url":"https://codeload.github.com/skycoin/skybian/tar.gz/refs/heads/master","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/skycoin%2Fskybian/sbom","scorecard":{"id":830519,"data":{"date":"2025-08-11","repo":{"name":"github.com/skycoin/skybian","commit":"6de3cb77957184664ce9f15eac2b1f34dfdf889e"},"scorecard":{"version":"v5.2.1-40-gf6ed084d","commit":"f6ed084d17c9236477efd66e5b258b9d4cc7b389"},"score":2.3,"checks":[{"name":"Dangerous-Workflow","score":-1,"reason":"no workflows found","details":null,"documentation":{"short":"Determines if the project's GitHub Action workflows avoid dangerous patterns.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#dangerous-workflow"}},{"name":"Token-Permissions","score":-1,"reason":"No tokens found","details":null,"documentation":{"short":"Determines if the project's workflows follow the principle of least privilege.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#token-permissions"}},{"name":"Packaging","score":-1,"reason":"packaging workflow not detected","details":["Warn: no GitHub/GitLab publishing workflow detected."],"documentation":{"short":"Determines if the project is published as a package that others can easily download, install, easily update, and uninstall.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#packaging"}},{"name":"SAST","score":0,"reason":"no SAST tool detected","details":["Warn: no pull requests merged into dev branch"],"documentation":{"short":"Determines if the project uses static code analysis.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#sast"}},{"name":"Code-Review","score":0,"reason":"Found 0/30 approved changesets -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project requires human code review before pull requests (aka merge requests) are merged.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#code-review"}},{"name":"Binary-Artifacts","score":10,"reason":"no binaries found in the repo","details":null,"documentation":{"short":"Determines if the project has generated executable (binary) artifacts in the source repository.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#binary-artifacts"}},{"name":"Maintained","score":0,"reason":"0 commit(s) and 0 issue activity found in the last 90 days -- score normalized to 0","details":null,"documentation":{"short":"Determines if the project is \"actively maintained\".","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#maintained"}},{"name":"CII-Best-Practices","score":0,"reason":"no effort to earn an OpenSSF best practices badge detected","details":null,"documentation":{"short":"Determines if the project has an OpenSSF (formerly CII) Best Practices Badge.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#cii-best-practices"}},{"name":"Pinned-Dependencies","score":-1,"reason":"no dependencies found","details":null,"documentation":{"short":"Determines if the project has declared and pinned the dependencies of its build process.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#pinned-dependencies"}},{"name":"Security-Policy","score":0,"reason":"security policy file not detected","details":["Warn: no security policy file detected","Warn: no security file to analyze","Warn: no security file to analyze","Warn: no security file to analyze"],"documentation":{"short":"Determines if the project has published a security policy.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#security-policy"}},{"name":"License","score":0,"reason":"license file not detected","details":["Warn: project does not have a license file"],"documentation":{"short":"Determines if the project has defined a license.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#license"}},{"name":"Fuzzing","score":0,"reason":"project is not fuzzed","details":["Warn: no fuzzer integrations found"],"documentation":{"short":"Determines if the project uses fuzzing.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#fuzzing"}},{"name":"Vulnerabilities","score":10,"reason":"0 existing vulnerabilities detected","details":null,"documentation":{"short":"Determines if the project has open, known unfixed vulnerabilities.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#vulnerabilities"}},{"name":"Signed-Releases","score":0,"reason":"Project has not signed or included provenance with any releases.","details":["Warn: release artifact v1.2.1 not signed: https://api.github.com/repos/skycoin/skybian/releases/78965988","Warn: release artifact v1.0.0 not signed: https://api.github.com/repos/skycoin/skybian/releases/71508229","Warn: release artifact v0.5.0 not signed: https://api.github.com/repos/skycoin/skybian/releases/59823063","Warn: release artifact v0.4.0 not signed: https://api.github.com/repos/skycoin/skybian/releases/51808614","Warn: release artifact v0.3.1 not signed: https://api.github.com/repos/skycoin/skybian/releases/45510913","Warn: release artifact v1.2.1 does not have provenance: https://api.github.com/repos/skycoin/skybian/releases/78965988","Warn: release artifact v1.0.0 does not have provenance: https://api.github.com/repos/skycoin/skybian/releases/71508229","Warn: release artifact v0.5.0 does not have provenance: https://api.github.com/repos/skycoin/skybian/releases/59823063","Warn: release artifact v0.4.0 does not have provenance: https://api.github.com/repos/skycoin/skybian/releases/51808614","Warn: release artifact v0.3.1 does not have provenance: https://api.github.com/repos/skycoin/skybian/releases/45510913"],"documentation":{"short":"Determines if the project cryptographically signs release artifacts.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#signed-releases"}},{"name":"Branch-Protection","score":0,"reason":"branch protection not enabled on development/release branches","details":["Warn: branch protection not enabled for branch 'master'"],"documentation":{"short":"Determines if the default and release branches are protected with GitHub's branch protection settings.","url":"https://github.com/ossf/scorecard/blob/f6ed084d17c9236477efd66e5b258b9d4cc7b389/docs/checks.md#branch-protection"}}]},"last_synced_at":"2025-08-23T17:39:55.490Z","repository_id":39713837,"created_at":"2025-08-23T17:39:55.490Z","updated_at":"2025-08-23T17:39:55.490Z"},"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":29169389,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-02-06T16:33:35.550Z","status":"ssl_error","status_checked_at":"2026-02-06T16:33:30.716Z","response_time":59,"last_error":"SSL_connect returned=1 errno=0 peeraddr=140.82.121.5:443 state=error: 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":["skybian-image","skywire"],"created_at":"2026-02-06T17:11:06.037Z","updated_at":"2026-02-06T17:11:06.695Z","avatar_url":"https://github.com/skycoin.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Skybian Image\n\nThe Skybian image is a Debian-based ARM Operating System image with skywire pre-installed.\n\nCurrently, the following SBCs (Single Board Computer) are supported:\n\n* Orange Pi Prime\n* Orange Pi 3\n* Raspberry Pi 32-bit and 64-bit\n\nThis repository has two types of builds:\n\nThe first is a [PKGBUILD](PKGBUILD) for the skybian.deb packaged modifications to the base image.\n\nThe second are [IMGBUILD](skybian.prime.IMGBUILD)s, which modify a base Armbian or Raspbian images by installing the skybian and skywire-bin packages, setting the password, etc.\n\nRelease images for can be found at [https://deb.skywire.skycoin.com/img/](https://deb.skywire.skycoin.com/img)\n\n### Prerequisite\n\nTo build everything in this repo requires:\n\n* archlinux host\n* ~15gb of disk space\n\n### Build Skybian image:\n\ninstall dependencies from AUR:\n```\nyay -S 'arch-install-scripts' 'aria2' 'dpkg' 'dtrx' 'qemu-arm-static' 'zip'\n```\nNote: be sure to install the binary package `qemu-arm-static-bin` if you don't have `qemu-arm-static` installed already.\n\nBuild only without creating an archive:\n```\nmakepkg --noarchive -p skybian.prime.IMGBUILD\n```\n\nOnce the image is created, it can be compressed into the desired archive format:\n```\nPKGEXT='.img.tar.zst' makepkg -fRp skybian.prime.IMGBUILD\nPKGEXT='.img.tar.xz' makepkg -fRp skybian.prime.IMGBUILD\nPKGEXT='.img.tar.gz' makepkg -fRp skybian.prime.IMGBUILD\n```\n\nUpdate checksums on changes to source files:\n```\nupdpkgsums skybian.prime.IMGBUILD\n```\n\n### Skybian .deb package:\n\nThe skybian amd64 package includes only the apt repo configuration and repository signing key.\n\nThe skybian armhf and arm64 packages additionally contain the modifications to the base image ; when installed in a chroot, the skybian package enables the automatic remote hypervisor configuration on the first boot of the skybian image to a hypervisor running on the xxx.xxx.xxx.2 ip address of the current subnet.\n\nto build the skybian package, first install dpkg from the AUR:\n```\nyay -S dpkg\n```\n\nBuild the skybian .deb package:\n```\nmakepkg\n```\n\nOn changes to source files in [script](script) or [static](static) dir ; re-create the source archive(s):\n```\ntar -czvf skybian-static.tar.gz static\ntar -czvf skybian-script.tar.gz script\n```\n\nUpdate checksums of source archives in the [PKGBUILD](PKGBUILD):\n```\nupdpkgsums\n```\n\n### Building Both\n\n An automated development workflow is made possible with the skybian-prime.sh and skybian.sh scripts, which build the image and package respectively. The version of the skybian and skywire packages *must match* the version referenced in the skybian.prime.IMGBUILD:\n ```\n ./skybian.sh\n SKYBIAN=skybian.prime.IMGBUILD ./image.sh\n```\n\n### Building Image Variants\norange pi prime\n```\nSKYBIAN=skybian.prime.IMGBUILD ./image.sh 1\n./skybian-prime.sh 1\n```\norange pi prime with autopeering\n```\nENABLEAUTOPEER=\"-autopeer\" SKYBIAN=skybian.prime.IMGBUILD ./image.sh 1\n```\n\norange pi 3\n```\nSKYBIAN=skybian.opi3.IMGBUILD ./image.sh 1\n ```\nraspberry pi 3\n ```\n SKYBIAN=skyraspbian.rpi3.IMGBUILD ./image.sh 1\n ```\nraspberry pi 4\n ```\n SKYBIAN=skyraspbian.rpi4.IMGBUILD ./image.sh 1\n ```\n\n### Skybian Auto-Peering Explained\n\nThe Skybian orange pi prime image, when booted, checks for any machine on the network at the xxx.xxx.xxx.2 ip address of the current subnet; i.e. 192.168.0.2 [skymanager.sh](/skymanager.sh).\n\n#### _If nothing is on that ip address;_\n* a static IP is set to that address via systemd-networkd in `/etc/systemd/network/10-eth.network`\n* A hypervisor configuration is created by the skywire-autoconfig script.\n* skywire.service is started\n* srvpk.service is started ; which is an http endpoint runing on :7998 for querying the hypervisor's public key (`skywire-cli visor pk -w`)\n\n#### _If a machine is on that ip address;_\n* the skywire systemd service is started.\n* the hypervisor running at the .2 ip address of the current subnet is queried for its public key\n* the public key is not written to the config, but established at runtime\n* upon loss of connection to the hypervisor, the srvpk endpoint is queried until a hypervisor responds with its public key or until the previous hypervisor connection is re-established\n\nIf no configuration file was generated, the process is attempted again on reboot.\n\n### Using the Skybian image\n\nRefer to the [Skybian User Guide](https://github.com/skycoin/skywire/wiki/Skybian-User-Guide) in the [skywire github wiki](https://github.com/skycoin/skywire/wiki).\n\n### Troubleshooting\n\nIf for some reason the hypervisor is not accessible or the visor never shows up in the hypervisor, first try rebooting that board.\n\nIf the visor or hypervisor still does not show up online, ssh to the board or access it via keyboard and HDMI monitor.\n\nFor troubleshooting the skywire package, see [Skywire Package Installation](https://github.com/skycoin/skywire/wiki/Skywire-Package-Installation).\n\n### APT repository\n\nSkywire is now available as a package from the repository at [https://deb.skywire.skycoin.com](https://deb.skywire.skycoin.com).\n\nThis package repository will work with any .deb based arm / arm64 / amd64 system and is pre-configured in the provided Skybian and Skyraspbian images.\n\nTo configure this repository please refer to [Skywire Package Installation](https://github.com/skycoin/skywire/wiki/Skywire-Package-Installation).\n\n### Additional notes\n\nImages for testing can be found at [https://deb.skywire.dev/img/](https://deb.skywire.dev/img)\n\n### Script and systemd service reference\n\n#### Skybian\n* [skymanager.sh](/script/skymanager.sh) (formerly skybian-firstrun)\n    - produces static IP configuration (hypervisor)\n    - sets hostname (hypervisor)\n    - generates the appropriate config with skywire-autoconfig (local or remote hypervisor)\n    - disables skymanager.service\n* [skymanager.service](/script/skymanager.service)\n    - runs on skybian first boot; wants network-online.target and the wait-online.services\n* [srvpk.service](/util/srvpk.service)\n    - wants skywire.service\n\t- runs `skywire-cli hv srvpk`\n* [skybian-chrootconfig.sh](/script/skybian-chrootconfig.sh) (expected to run in chroot)\n    - called by [postinst.sh](/script/postinst.sh) of the skybian.deb package upon installation\n    - disables and enables required systemd services\n    - removes any autogenerated skywire config\n\t- produces the drop-in configuration for skywire systemd service to enable autopeering\n* /etc/systemd/system/skywire.service.conf.d/skywire.conf\n\t- `Environment=AUTOPEER=1`\n* [skybian-reset.sh](/script/skybian-reset.sh)\n    - resets skybian; except for the static ip configuration and hostname\n\n\n#### Skywire\n* skywire-autoconfig.sh\n    - produces or updates a skywire configuration\n    - determines the correct systemd service to enable and start by the presence of the config file\n    - takes public key as argument to create a remote hypervisor configuration\n* skywire.service\n    - `skywire -p`\n\n### ArchlinuxARM image\n\nAn archlinuxARM IMGBUILD for raspberry pis has been provided for advanced users. This image contains the unmodified archlinuxARM root filesystem. It is left to the user to install skywire or skywire-bin from the [AUR](aur.archlinux.org) after they have completed initial system configuration. It is recommended to use `yay` to install skywire-bin from the AUR. The same scripts are included with the AUR package of skywire as the debian package, and the installation paths are identical.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskycoin%2Fskybian","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fskycoin%2Fskybian","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fskycoin%2Fskybian/lists"}