{"id":19515062,"url":"https://github.com/opnsense/update","last_synced_at":"2025-04-13T07:47:47.927Z","repository":{"id":48856615,"uuid":"42802784","full_name":"opnsense/update","owner":"opnsense","description":"OPNsense update tools","archived":false,"fork":false,"pushed_at":"2025-02-06T08:15:15.000Z","size":404,"stargazers_count":142,"open_issues_count":2,"forks_count":81,"subscribers_count":26,"default_branch":"master","last_synced_at":"2025-04-13T07:47:38.646Z","etag":null,"topics":["hacktoberfest"],"latest_commit_sha":null,"homepage":"https://opnsense.org/","language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"bsd-2-clause","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/opnsense.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":"2015-09-20T06:29:32.000Z","updated_at":"2025-04-07T12:34:08.000Z","dependencies_parsed_at":"2024-04-04T10:28:28.319Z","dependency_job_id":"8f6db1ad-2d08-4421-93cb-701f83f51b4e","html_url":"https://github.com/opnsense/update","commit_stats":{"total_commits":524,"total_committers":9,"mean_commits":58.22222222222222,"dds":0.01526717557251911,"last_synced_commit":"001a3c2f3bf6124fbdd9dc772ad87ed73e3cd3df"},"previous_names":[],"tags_count":82,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opnsense%2Fupdate","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opnsense%2Fupdate/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opnsense%2Fupdate/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/opnsense%2Fupdate/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/opnsense","download_url":"https://codeload.github.com/opnsense/update/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248681494,"owners_count":21144700,"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":["hacktoberfest"],"created_at":"2024-11-10T23:38:29.311Z","updated_at":"2025-04-13T07:47:47.889Z","avatar_url":"https://github.com/opnsense.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"OPNsense update utilities\n=========================\n\nThis is a collection of firmware upgrade tools specifically written\nfor OPNsense based on FreeBSD ideas (kernel and base sets) and tools\n(pkg(8) and freebsd-update(8)).\n\nopnsense-update\n===============\n\nopnsense-update(8) unifies the update process into a single tool\nusable from the command line. Since OPNsense uses FreeBSD's package\nmanager, but not the native upgrade mechanism, an alternative way\nof doing base and kernel updates needed to be introduced.\n\nThe process relies on signature verification for all moving parts\n(packages and sets) by plugging into pkg(8)'s native verification\nmechanisms.\n\nThe utility was first introduced in February 2015.  In October 2016,\nmajor FreeBSD version upgrade support was added.  In August 2017,\ndebug kernel support was added.\n\nopnsense-bootstrap\n==================\n\nopnsense-bootstrap(8) is a tool that can completely reinstall a\nrunning system in place for a thorough factory reset or to restore\nconsistency of all the OPNsense files.  It can also wipe the\nconfiguration directory, but won't do that by default.\n\nIt will automatically pick up the latest available version and\nbuild a chain of trust by using current package fingerprints -\u003e CA\nroot certificates -\u003e HTTPS -\u003e OPNsense package fingerprints.\n\nWhat it will also do is turn a supported stock FreeBSD release into\nan OPNsense installation.  Both UFS and ZFS installations are supported.\n\nThe usage is simple, starting with a FreeBSD 14.2-RELEASE image:\n\n    # fetch https://raw.githubusercontent.com/opnsense/update/master/src/bootstrap/opnsense-bootstrap.sh.in\n    # sh ./opnsense-bootstrap.sh.in -r 25.1\n\nAfter successful reboot, OPNsense should be up and running.  :)\n\nThe utility was first introduced in November 2015.\n\nopnsense-sign, opnsense-verify\n==============================\n\nopnsense-sign(8) and opnsense-verify(8) sign and verify arbitrary\nfiles using signature verification methods available by pkg(8),\nso that a single key store can be used for packages and sets.\n\nopnsense-verify(8) is based on the existing pkg bootstrap code present\nin the FreeBSD base code, but has been improved for multi-repo use.\n\nBoth utilities were first introduced in December 2015.\n\nopnsense-fetch\n==============\n\nopnsense-fetch(8) creates a watcher process for fetch(1) and passes\nall arguments to it.  The watcher then prints progress output to the\nactual caller to indicate ongoing download progress.\n\nThe utility was first introduced in April 2016.\n\nopnsense-patch\n==============\n\nopnsense-patch(8) applies upstream git(1) patches in the order that they\nhave been given.  This helps to deploy fixes faster without the need\nto run manual edits or file downloads since patch(1) tries to keep the\nfile integrity intact.\n\nThe utility was first introduced in May 2016 to enable core and plugins\npatching.  In February 2019, a local caching mechanism was added to provide\noffline patching capability.  In July 2021 support for patching installer\nand update tools was added.\n\nopnsense-code\n=============\n\nDeriving from the utility of opnsense-patch(8), its younger sibling\nopnsense-code(8) can handle full code repositories using git(1)\nin order to fetch or update the full source code on an installed system.\n\nThe utility was first introduced in August 2016.\n\nopnsense-revert\n===============\n\nIn the available scope of the package mirrors, this utility can\nrevert any package to a previous state of a particular OPNsense\nrelease.\n\nThe utility was first introduced in January 2017.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopnsense%2Fupdate","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fopnsense%2Fupdate","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fopnsense%2Fupdate/lists"}