{"id":31704127,"url":"https://github.com/wide-vsix/vsixpi","last_synced_at":"2025-10-08T22:50:16.656Z","repository":{"id":47261610,"uuid":"394852167","full_name":"wide-vsix/vsixpi","owner":"wide-vsix","description":"Raspberry Pi ベースのvSIXアクセスルータ","archived":false,"fork":false,"pushed_at":"2022-01-01T14:56:22.000Z","size":141,"stargazers_count":12,"open_issues_count":1,"forks_count":0,"subscribers_count":3,"default_branch":"main","last_synced_at":"2023-03-10T05:41:14.802Z","etag":null,"topics":["access-service","cloud-config"],"latest_commit_sha":null,"homepage":"","language":"Jinja","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/wide-vsix.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":".github/CODEOWNERS","security":null,"support":null}},"created_at":"2021-08-11T03:39:23.000Z","updated_at":"2022-04-15T13:43:02.000Z","dependencies_parsed_at":"2022-08-20T05:11:06.828Z","dependency_job_id":null,"html_url":"https://github.com/wide-vsix/vsixpi","commit_stats":null,"previous_names":[],"tags_count":null,"template":null,"template_full_name":null,"purl":"pkg:github/wide-vsix/vsixpi","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wide-vsix%2Fvsixpi","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wide-vsix%2Fvsixpi/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wide-vsix%2Fvsixpi/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wide-vsix%2Fvsixpi/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/wide-vsix","download_url":"https://codeload.github.com/wide-vsix/vsixpi/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/wide-vsix%2Fvsixpi/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":279000771,"owners_count":26082851,"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","status":"online","status_checked_at":"2025-10-08T02:00:06.501Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"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":["access-service","cloud-config"],"created_at":"2025-10-08T22:50:07.613Z","updated_at":"2025-10-08T22:50:16.649Z","avatar_url":"https://github.com/wide-vsix.png","language":"Jinja","funding_links":[],"categories":[],"sub_categories":[],"readme":"![](https://i.imgur.com/AluMwI0.png)\n\n# vSIX Pi\n[![](http://img.shields.io/github/license/wide-vsix/vsixpi)](LICENSE) [![](https://img.shields.io/github/issues/wide-vsix/vsixpi)](https://github.com/wide-vsix/vsixpi/issues) [![](https://img.shields.io/github/issues-pr/wide-vsix/vsixpi)](https://github.com/wide-vsix/vsixpi/pulls) [![](https://img.shields.io/github/last-commit/wide-vsix/vsixpi)](https://github.com/wide-vsix/vsixpi/commits) [![](https://img.shields.io/github/release/wide-vsix/vsixpi)](https://github.com/wide-vsix/vsixpi/releases)\n\nMake your Raspberry Pi a vSIX access router with cloud-init.\n\n**NOTE:** This cloud-config is for Raspberry Pi - might work on other Ubuntu machines as well but not guaranteed.\n\n## Specs of vSIX Pi\nvSIX Pi is a Raspberry Pi-based broadband router officially maintained by vSIX Project. It supports the following features as of September 1, 2021, making it easy for anyone to experience Internet access via vSIX - AS4690.\n\n- **Connect to vSIX directly through NGN** - no need to pay your ISP anymore. Connection through the WIDE-BB is also supported \n- **Living in a multi-prefix network** - connect to two or more tunnel providers simultaneously and advertise multiple prefixes with RA\n- Use with wireless - your Pi become a fast Wi-Fi access point supporting 11n/ac\n- Use with wired - support Ethernet connection via additional USB NICs or tagged VLAN on the onboard NIC\n\n**You need to be a member of vSIX Working Group** - read [our website](https://www.vsix.wide.ad.jp/) carefully and get the invitation from us.\n\n### Prerequisites\nApply the Generic Tunneling Access Service from [vSIX Portal](https://portal.vsix.wide.ad.jp/), and get the IPv6 prefixes delegated. The following information is needed to set up vSIX Pi; all of them are displayed on the Portal.\n\n- **Your global IPv6 address** - customer endpoint (CE) address, also needed for the prior submission. Typically, this address is allocated from your ISP (VNE)\n- **IPv6 addresses of each tunnel provider** - provider endpoint (PE) addresses\n- **Delegated IPv6 prefixes of each site** - `/60` of address space is allocated for every PE\n\nPrepare a Raspberry Pi. The authors, the vSIX Access Service Team, tested using the series 4B with 2GB of RAM and 16GB of storage. It might also work with the series 3B, although Wi-Fi and Ethernet performance would be degraded - check  [hardware specifications](https://en.wikipedia.org/wiki/Raspberry_Pi#Specifications) of your Pi. In summary, the minimum system requirements are as follows:\n\n- **Ubuntu Server 20.04 and later** installed on **series 3B and later**\n- More than **1GB** of RAM\n- More than **8GB** of SD card capacity\n\nThanks to [cloud-init](https://cloudinit.readthedocs.io/en/latest/), installation and setup procedures are fully automated. All you have to do is *1)* edit a simple configuration file in YAML format and *2)* type a single command to generate cloud-config.\n\n## Getting started with your Raspberry Pi\nFirst, shallow clone this repository and install dependent libraries with:\n\n```\n% git clone --depth 1 https://github.com/wide-vsix/cloud-init-vsixpi\n% cd cloud-init-vsixpi\n% pipenv update\n```\n\nNext, override the example variables adjusting with your environment. Follow the instructions in the comments carefully.\n\n```\n% cp vsixpi.yml.example vsixpi.yml\n% vim vsixpi.yml\n```\n\nFinally, build the cloud-config templates - the outputs are in the `cloud-config` directory.\n\n```\n% pipenv run generate\n% bat cloud-config/user-data -l yaml\n```\n\n### For newbies\nDownload the latest Ubuntu Server from [here](https://ubuntu.com/download/raspberry-pi) - the LTS release is recommended, but totally up to you. Then extract `.xz` archive and burn your SD card.\n\nFor macOS users, this is like the following:\n\n```\n% diskutil list                         # Check where the SD card is mounted\n% sudo diskutil unmountDisk /dev/disk2  # Suppose /dev/disk2 is the SD card\n% # Specify target path as /dev/rdisk2 instead of /dev/disk2 - it will fasten the writing\n% sudo gdd bs=16M status=progress if=./ubuntu-20.04.2-preinstalled-server-arm64+raspi.img of=/dev/rdisk2\n```\n\nWhen the writing is completed, the SD card will be remounted as `system-boot`. Copy all the files under the `cloud-config` directory to this area and overwrite the default cloud-config.\n\nConnect LAN cable to the onboard NIC, insert the SD card, and turn on the power. cloud-init is called during the initial boot sequence, and this is why the first startup takes a relatively long time - it is about 30 minutes in the author's environment, though it depends mainly on your network bandwidth. Note that your Pi will automatically reboot once during the cloud-init setup. Hang tight until the console is entirely silent.\n\nYou will see a Wi-Fi named VSIX-FREE-WIFI by default. If you connect it with `Adios,IPv4!`, RDNSS will complete the address configuration and ready you to experience the vSIX access service - of course, you can change the SSID and password. Welcome to vSIX! Let's test your connectivity at [test-ipv6.com](https://test-ipv6.com/).\n\n**FYI:** [iNonius Project](https://inonius.net/) provides the speed test service for both IPv4 and IPv6.\n\nIf you need further assistance, don't hesitate to ask questions at [#helpme](https://app.slack.com/client/T022V857XM4/C02DBTWM0JX) of our Slack. The vSIX developers will support you one by one for any kind of request.\n\n## Hints and tips from vSIX developers\nBelow are hints and tips for the advanced use of vSIX Pi.\n\n### Traffic monitoring\nOpen your favorite browser and go to [http://vsixpi.local:19999](http://vsixpi.local:19999) to see [Netdata](https://www.netdata.cloud/) monitoring dashboard.\n\n[![](https://i.imgur.com/nHMLnWY.png)](https://i.imgur.com/nHMLnWY.png)\n[![](https://i.imgur.com/uYjA47F.png)](https://i.imgur.com/uYjA47F.png)\n\n**ATTENTION:** If you would like to help us improve our service quality, please run the following command on your Pi. Netbox will send your Pi's metrics to our account, enabling us to detect the deterioration quickly.\n\n```\n% sudo docker exec -it netdata netdata-claim.sh \\\n    -token=HMWaSQ0c3eTe_NE3qXW2RNi8uK5aWKRvY__pO8Z8rcIKsd90duT4zzeHqHGV8phaKzp-7QGK1-o9RIEPNL_nH1j_eD6xL_lubBBKoYYcXOqJThubqomLNwm4gE-1x56yFSNvJpk \\\n    -rooms=0e12b8e6-bf96-4d10-aabd-a3f0976f43de,7a52dc34-6231-4dee-8fb2-fd7259b77e3f \\\n    -url=https://app.netdata.cloud\n```\n\n### Reconfigure your vSIX Pi after cloud-init\nThe following updates can be applied by editing the `vsixpi.yml`:\n\n- Change CE address and PE addresses - discarding or moving tunnels\n- Change SSID, passphrase, and radio channel\n- Change VLAN ID of the onboard NIC, install or uninstall USB Ethernet adapters\n- Change RA related parameters as well as MTU and TCP MSS Clamping\n\nRemember to reboot after the reconfiguration; otherwise, the system will be unstable, or some configuration will not be applied appropriately.\n\n```\n% cd /var/lib/vsixpi\n% sudo vim vsixpi.yml\n% sudo pipenv run reconfigure\n% sudo reboot\n```\n\n**CAUTION:** This operation is destructive - it overwrites each configuration file, and any manual changes made to them will be lost.\n\nIf you need to regenerate all configurations every before shutdown automatically, use `auto_reconf: yes` in `vsixpi.yml` and type:\n\n```\n% sudo systemctl enable --now vsixpi-auto-reconf.service\n```\n\nThis option is advantageous if you don't know much about Linux and don't want to touch anything but `vsixpi.yml`.\n\n## Announcements\nCheck [issues](https://github.com/wide-vsix/cloud-init-vsixpi/issues) and [pull requests](https://github.com/wide-vsix/cloud-init-vsixpi/pulls) as well.\n\n### Planned new features and upcoming releases\n\n- Perform periodical health checks from vSIX Pis to automatically detect failures of the access service or backbone network - currently being undertaken and developed with the [@SINDAN](https://github.com/SINDAN) project\n- Selective RA based on an automatic tunnel quality measurement for IPv6 multi-prefix environment\n\n### Known issues and workarounds\n\n- ~~Currently, the auto-reconfiguration feature doesn't work. We're trying to fix the bugs, and kindly follow the above [manual reconfigure procedure](https://github.com/wide-vsix/vsixpi#reconfigure-your-vsix-pi-after-cloud-init) for the time being~~ Fixed by [Pull Request #11](https://github.com/wide-vsix/vsixpi/pull/11) and available in [v21.09.06](https://github.com/wide-vsix/vsixpi/releases/tag/21.09.06) and later releases\n\n## Maintainers\nThis repository is maintained by the vSIX Access Service Team and supported by many volunteers. Followings are responsible for reviewing pull requests:\n\n- **miya** - *Author of the initial release* [@mi2428](https://github.com/mi2428)\n- **hide** - *Co-author of the initial release* [@hdfln](https://github.com/hdfln)\n\nSee also the list of [contributors](https://github.com/wide-vsix/vsixpi/graphs/contributors) who participated in this project.\n\n## License\nThis product is licensed under [The 2-Clause BSD License](https://opensource.org/licenses/BSD-2-Clause) - see the [LICENSE](LICENSE) file for details.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwide-vsix%2Fvsixpi","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fwide-vsix%2Fvsixpi","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fwide-vsix%2Fvsixpi/lists"}