{"id":20063464,"url":"https://github.com/vanilla-os/vib-fsguard","last_synced_at":"2025-05-05T17:32:55.513Z","repository":{"id":215284734,"uuid":"738500166","full_name":"Vanilla-OS/vib-fsguard","owner":"Vanilla-OS","description":"A vib plugin that sets up fsguard and generates the filelist","archived":false,"fork":false,"pushed_at":"2025-02-25T13:44:02.000Z","size":53,"stargazers_count":2,"open_issues_count":1,"forks_count":3,"subscribers_count":5,"default_branch":"main","last_synced_at":"2025-04-09T02:11:15.614Z","etag":null,"topics":["vanilla-os","vib","vib-plugin"],"latest_commit_sha":null,"homepage":"","language":"Go","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/Vanilla-OS.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},"funding":{"github":"vanilla-os","liberapay":"fabricators"}},"created_at":"2024-01-03T11:20:00.000Z","updated_at":"2025-04-04T03:42:51.000Z","dependencies_parsed_at":"2024-02-07T08:31:49.837Z","dependency_job_id":"435f4266-c769-49ab-8519-7c40bacb1e79","html_url":"https://github.com/Vanilla-OS/vib-fsguard","commit_stats":null,"previous_names":["vanilla-os/vib-fsguard"],"tags_count":18,"template":false,"template_full_name":"Vanilla-OS/vib-plugin","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanilla-OS%2Fvib-fsguard","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanilla-OS%2Fvib-fsguard/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanilla-OS%2Fvib-fsguard/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/Vanilla-OS%2Fvib-fsguard/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/Vanilla-OS","download_url":"https://codeload.github.com/Vanilla-OS/vib-fsguard/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":252542431,"owners_count":21764968,"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":["vanilla-os","vib","vib-plugin"],"created_at":"2024-11-13T13:42:21.478Z","updated_at":"2025-05-05T17:32:55.202Z","avatar_url":"https://github.com/Vanilla-OS.png","language":"Go","funding_links":["https://github.com/sponsors/vanilla-os","https://liberapay.com/fabricators"],"categories":[],"sub_categories":[],"readme":"\n# vib-fsguard\n\n[Vib](https://github.com/vanilla-os/vib) plugin that sets up fsguard and generates a filelist.\n\nThis plugin requires that `minisign` is installed in the image, this can be easily done with a nested module\n\n## Module Structure\n\n```yaml\n- name: fsguard\n  type: fsguard\n  CustomFsGuard: false\n  FsGuardLocation: \"/usr/bin/\"\n  GenerateKey: true\n  FilelistPaths: [\"/usr/bin/\"]\n  modules:\n    - name: minisign\n      type: apt\n      sources:\n        packages:\n            - \"minisign\"\n```\n\nIf `GenerateKey` is set to false, `KeyPath` has to be specified, pointing to a location in the container (e.g. added through includes.container) which contains already existing minisign keys:\n\n```yaml\n- name: fsguard\n  type: fsguard\n  CustomFsGuard: false\n  FsGuardLocation: \"/usr/bin/\"\n  GenerateKey: false\n  KeyPath: \"/etc/minisign/\"\n  FilelistPaths: [\"/usr/bin/\"]\n  modules:\n    - name: minisign\n      type: apt\n      sources:\n        packages:\n            - \"minisign\" \n```\n\nNote that the keys must be named `minisign.pub` (public) and `minisign.key` (private) in this example the minisign keys would be in `includes.container/etc/minisign/`, which translates to `/etc/minisign** in the build environment\n\nKeep in mind that the minisign key **cannot** be password protected, as there is no way for the user to type in the password during building (which is why always generting a random key through GenerateKey is recommended)\n\nIn the case that FsGuard has to be manually built (due to a configuration change or similiar), the `CustomFsGuard` option has to be set to True, this stops the module from fetching a prebuilt FsGuard and instead allows the user to manually build FsGuard, it does however expect the FsGuard binary to be at `/sources/FsGuard`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanilla-os%2Fvib-fsguard","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvanilla-os%2Fvib-fsguard","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvanilla-os%2Fvib-fsguard/lists"}