{"id":24448482,"url":"https://github.com/valldrac/onionwall-vagrant","last_synced_at":"2025-09-03T13:07:57.446Z","repository":{"id":241103244,"uuid":"162989595","full_name":"valldrac/onionwall-vagrant","owner":"valldrac","description":"Vagrant config for building and developing OnionWall.","archived":false,"fork":false,"pushed_at":"2019-01-30T00:01:40.000Z","size":7,"stargazers_count":0,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-21T00:19:34.444Z","etag":null,"topics":["gitlab-mirror"],"latest_commit_sha":null,"homepage":"https://gitlab.com/valldrac/onionwall-vagrant","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/valldrac.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"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":"2018-12-24T12:40:59.000Z","updated_at":"2019-01-30T00:01:41.000Z","dependencies_parsed_at":"2024-05-22T12:53:06.660Z","dependency_job_id":null,"html_url":"https://github.com/valldrac/onionwall-vagrant","commit_stats":null,"previous_names":["valldrac/onionwall-vagrant"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valldrac%2Fonionwall-vagrant","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valldrac%2Fonionwall-vagrant/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valldrac%2Fonionwall-vagrant/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/valldrac%2Fonionwall-vagrant/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/valldrac","download_url":"https://codeload.github.com/valldrac/onionwall-vagrant/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":243527326,"owners_count":20305198,"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":["gitlab-mirror"],"created_at":"2025-01-21T00:19:18.127Z","updated_at":"2025-03-14T05:21:27.341Z","avatar_url":"https://github.com/valldrac.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Vagrantfile for OnionWall development\n\nTo generate a flashable firmare of [OnionWall](https://gitlab.com/valldrac/onionwall) you need to setup the [OpenWrt buildroot](https://openwrt.org/docs/guide-developer/build-system/install-buildsystem) on a compatible OS and filesystem (case sensitive).\n\nThis [Vagrant](https://www.vagrantup.com/) environment makes the process very easy on just about every platform.\n\n## Bootstrapping the Vagrant Box\n\n```\n$ git clone --recursive https://gitlab.com/valldrac/onionwall-vagrant.git\n$ cd onionwall-vagrant\n$ vagrant up\n```\n\nThe **buildroot** will be available in the VM path `/onionwall` when the provisioning script is complete.\n\n## Building OnionWall\n\nTo proceed and build the firmware run this single command. It will SSH for you into the buildroot and will make all the magic:\n\n```\n$ make firmware\n```\n\nWhen finished, check out the image file with suffix `squashfs-sysupgrade.bin` in the host directory `firmware/bin/targets` and refer to https://gitlab.com/valldrac/onionwall/wikis/Flashing how-to.\n\nIf the build fails, re-run make with **V=s** for debugging output.\n\n## Customizing OnionWall\n\nThe directory with the source code is configured as [rsynced shared folder](https://www.vagrantup.com/docs/synced-folders/rsync.html). It is synchronized automatically to the buildroot by the Makefile. This way lets you to **edit the sources directly in the host** while being completely isolated from the build process.\n\nIf you want to customize the image through [menuconfig](https://openwrt.org/docs/guide-developer/build-system/use-buildsystem#make_menuconfig) try:\n\n```\n$ make menuconfig\n```\n\nThe above executes menuconfig in the buildroot and copies the config file back into the source tree. This file includes only the changes compared to the default configuration of OpenWrt.\n\n### Patching the kernel\n\nFollow https://openwrt.org/docs/guide-developer/build-system/use-patches-with-buildsystem:\n\n```\n$ vagrant ssh\n$ cd /onionwall\n$ make package/kernel/mac80211/{clean,prepare} V=s QUILT=1\n$ cd build_dir/target-mips_24kc_musl-1.1.16/linux-ar71xx_generic/compat-wireless-2017-01-31\n$ quilt push -a\n$ quilt new 999-ath9k_random_mac_address.patch\n$ quilt edit drivers/net/wireless/ath/ath9k/hw.c\n$ quilt refresh\n$ cd /onionwall\n$ make package/kernel/mac80211/update V=s\n$ make package/kernel/mac80211/{clean,compile} package/index V=s\n```\n\nCopy patch file back to the source tree:\n\n```\n$ vagrant scp default:/onionwall/package/kernel/mac80211/patches/999-ath9k_random_mac_address.patch onionwall/package/kernel/mac80211/patches \n```\n\n## Cleaning up\n\n```\n$ make clean\n```\n\nCleans the directory `firmware` and dot-files generated by Makefile, but it avoids touching the buildroot.\n\nAdditional targets to clean up the mess:\n\n* `make dirclean` runs `make clean` both in the host and in the buildroot.\n* `make distclean` runs `make clean` and deletes the buildroot completely in the VM.\n\nRemember you can recreate the Vagrant box at any time with `make clean \u0026\u0026 vagrant destroy \u0026\u0026 vagrant up`.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalldrac%2Fonionwall-vagrant","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fvalldrac%2Fonionwall-vagrant","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fvalldrac%2Fonionwall-vagrant/lists"}