Page Not Found
We could not find what you were looking for.
Please contact the owner of the site that linked you to the original URL and let them know their link is broken.
We could not find what you were looking for.
Please contact the owner of the site that linked you to the original URL and let them know their link is broken.
nmcli",id:"connecting-to-a-wifi-network-using-nmcli",level:3},{value:"Connecting to multiple networks simultaneously",id:"connecting-to-multiple-networks-simultaneously",level:3},{value:"Starting the Pioreactor local access point using nmcli",id:"starting-the-pioreactor-local-access-point-using-nmcli",level:3},{value:"Changing leader_address and MQTT broker in your config.ini",id:"changing-leader_address-and-mqtt-broker-in-your-configini",level:4},{value:"Changing web UI port from 80 to something else",id:"changing-web-ui-port-from-80-to-something-else",level:3},{value:"Connecting to eduroam",id:"connecting-to-eduroam",level:2},{value:"Common questions",id:"common-questions",level:2},{value:"My Pioreactor activities start very slowly from the UI",id:"my-pioreactor-activities-start-very-slowly-from-the-ui",level:3}];function d(e){const n={a:"a",admonition:"admonition",code:"code",em:"em",h2:"h2",h3:"h3",h4:"h4",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",...(0,t.a)(),...e.components};return(0,i.jsxs)(i.Fragment,{children:[(0,i.jsx)(n.admonition,{type:"info",children:(0,i.jsxs)(n.p,{children:["Previously, Raspberry Pis used a file called ",(0,i.jsx)(n.code,{children:"wpa_supplicant.conf"})," to handle wifi network connections. ",(0,i.jsx)(n.strong,{children:"This is not longer the case"}),". Modern Raspberry Pi software, including the Pioreactor, doesn't use ",(0,i.jsx)(n.code,{children:"wpa_supplicant.conf"})," at all. Instead, the tool ",(0,i.jsx)(n.code,{children:"nmcli"})," replaces it. Don't follow tutorials that use ",(0,i.jsx)(n.code,{children:"wpa_supplicant.conf"}),"."]})}),"\n",(0,i.jsx)(n.h2,{id:"general-networking-tools",children:"General networking tools"}),"\n",(0,i.jsxs)(n.p,{children:['The main "entry point" for networking on the Pioreactor (and Raspberry Pi\'s in general) is the tool ',(0,i.jsx)(n.code,{children:"nmcli"}),". This controls discovering networks, connecting to them, and editing connections. For example, running ",(0,i.jsx)(n.code,{children:"nmcli con"})," will diplay a list of possible networking connections, and connected ones in green."]}),"\n",(0,i.jsxs)(n.h3,{id:"connecting-to-a-wifi-network-using-nmcli",children:["Connecting to a wifi network using ",(0,i.jsx)(n.code,{children:"nmcli"})]}),"\n",(0,i.jsx)(n.p,{children:"You can first discover all the visible networks with:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{children:"sudo nmcli d wifi list\n"})}),"\n",(0,i.jsx)(n.p,{children:"If you see your network on the list, then run:"}),"\n",(0,i.jsx)(n.pre,{children:(0,i.jsx)(n.code,{children:"sudo nmcli device wifi connect nmcli",id:"connecting-to-a-wifi-network-using-nmcli",level:3},{value:"Connecting to multiple networks simultaneously",id:"connecting-to-multiple-networks-simultaneously",level:3},{value:"Starting the Pioreactor local access point using nmcli",id:"starting-the-pioreactor-local-access-point-using-nmcli",level:3},{value:"Changing leader_address and MQTT broker in your config.ini",id:"changing-leader_address-and-mqtt-broker-in-your-configini",level:4},{value:"Changing web UI port from 80 to something else",id:"changing-web-ui-port-from-80-to-something-else",level:3},{value:"Connecting to eduroam",id:"connecting-to-eduroam",level:2},{value:"Common questions",id:"common-questions",level:2},{value:"My Pioreactor activities start very slowly from the UI",id:"my-pioreactor-activities-start-very-slowly-from-the-ui",level:3}];function d(e){const n={a:"a",admonition:"admonition",code:"code",em:"em",h2:"h2",h3:"h3",h4:"h4",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",...(0,t.a)(),...e.components};return(0,o.jsxs)(o.Fragment,{children:[(0,o.jsx)(n.admonition,{type:"info",children:(0,o.jsxs)(n.p,{children:["Previously, Raspberry Pis used a file called ",(0,o.jsx)(n.code,{children:"wpa_supplicant.conf"})," to handle wifi network connections. ",(0,o.jsx)(n.strong,{children:"This is not longer the case"}),". Modern Raspberry Pi software, including the Pioreactor, doesn't use ",(0,o.jsx)(n.code,{children:"wpa_supplicant.conf"})," at all. Instead, the tool ",(0,o.jsx)(n.code,{children:"nmcli"})," replaces it. Don't follow tutorials that use ",(0,o.jsx)(n.code,{children:"wpa_supplicant.conf"}),"."]})}),"\n",(0,o.jsx)(n.h2,{id:"general-networking-tools",children:"General networking tools"}),"\n",(0,o.jsxs)(n.p,{children:['The main "entry point" for networking on the Pioreactor (and Raspberry Pi\'s in general) is the tool ',(0,o.jsx)(n.code,{children:"nmcli"}),". This controls discovering networks, connecting to them, and editing connections. For example, running ",(0,o.jsx)(n.code,{children:"nmcli con"})," will diplay a list of possible networking connections, and connected ones in green."]}),"\n",(0,o.jsxs)(n.h3,{id:"connecting-to-a-wifi-network-using-nmcli",children:["Connecting to a wifi network using ",(0,o.jsx)(n.code,{children:"nmcli"})]}),"\n",(0,o.jsx)(n.p,{children:"You can first discover all the visible networks with:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{children:"sudo nmcli d wifi list\n"})}),"\n",(0,o.jsx)(n.p,{children:"If you see your network on the list, then run:"}),"\n",(0,o.jsx)(n.pre,{children:(0,o.jsx)(n.code,{children:"sudo nmcli device wifi connect pioreactor network in the list of available wifi networks?",id:"do-you-see-the-pioreactor-network-in-the-list-of-available-wifi-networks",level:4},{value:"Alternatively, do you not see the pioreactor network in the list of available wifi networks?",id:"alternatively-do-you-not-see-the-pioreactor-network-in-the-list-of-available-wifi-networks",level:4},{value:"I'm on the network, but can't load the Pioreactor UI at http://pioreactor.local",id:"im-on-the-network-but-cant-load-the-pioreactor-ui-at-httppioreactorlocal",level:3},{value:"I can't connect a worker to my local access point",id:"i-cant-connect-a-worker-to-my-local-access-point",level:3},{value:"I'm pretty sure I'm at the limit of ~4-8 clients on my access point - what can I do?",id:"im-pretty-sure-im-at-the-limit-of-4-8-clients-on-my-access-point---what-can-i-do",level:3}];function h(e){const a={a:"a",admonition:"admonition",code:"code",em:"em",h2:"h2",h3:"h3",h4:"h4",img:"img",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,c.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(a.p,{children:"For some use cases, you may want to create a local WiFi network just for your Pioreactors (this is called a local access point, or a hotspot). Why might you want to do this?"}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsx)(a.li,{children:"If you want to get started right away, without dealing with exiting WiFi networks."}),"\n",(0,n.jsx)(a.li,{children:"If your usual WiFi network is restrictive (ex: doesn't allow Raspberry Pis, or requires IT support to host them)."}),"\n",(0,n.jsx)(a.li,{children:"If you want to take the Pioreactor, or cluster of Pioreactors, out into the field where there is no network."}),"\n"]}),"\n",(0,n.jsx)(a.p,{children:"The Pioreactor comes with the ability to create its own local access point, which other Pioreactors can connect to. See image below:"}),"\n",(0,n.jsx)(a.p,{children:(0,n.jsx)(a.img,{alt:"Using the Pioreactor to create a local access point",src:o(13726).Z+"",width:"1191",height:"387"})}),"\n",(0,n.jsx)(a.admonition,{type:"info",children:(0,n.jsx)(a.p,{children:"The built-in local access point is meant for small clusters of Pioreactors, and it's range and stability is limited. If you want a proper local access point, we suggest purchasing an inexpensive wifi router and using that (the router does not need to be connected to the internet - it will still create a wifi network you can connect Pioreactors to regardless)."})}),"\n",(0,n.jsx)(a.h2,{id:"starting-a-local-access-point",children:"Starting a local access point"}),"\n",(0,n.jsx)(a.p,{children:"The Pioreactor has the necessary software and hardware to create the local access point. To start the access point:"}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsxs)(a.li,{children:["If starting with a new Pioreactor, during software set up:","\n",(0,n.jsxs)(a.ol,{children:["\n",(0,n.jsxs)(a.li,{children:['Leave the "Configure wireless LAN" unchecked. Continue with the instructions at ',(0,n.jsx)(a.a,{href:"/user-guide/software-set-up#setting-up-your-raspberry-pi",children:"Setting up your Raspberry Pi"}),"."]}),"\n",(0,n.jsxs)(a.li,{children:["After the SD card has been written to, remove the SD card from your computer, and immediately insert it back in. A ",(0,n.jsx)(a.code,{children:"boot"})," (or ",(0,n.jsx)(a.code,{children:"bootfs"}),") device should be present now that is your SD card. If asked to reformat the SD card, select NO."]}),"\n",(0,n.jsxs)(a.li,{children:["\n",(0,n.jsx)(i,{}),"\n"]}),"\n",(0,n.jsxs)(a.li,{children:["Drag/move the downloaded ",(0,n.jsx)(a.code,{children:"local_access_point"})," file to the SD card directory."]}),"\n",(0,n.jsxs)(a.li,{children:["Eject the SD card safely, and continue with instructions at ",(0,n.jsx)(a.a,{href:"/user-guide/software-set-up#setting-up-your-raspberry-pi",children:"Setting up your Raspberry Pi"}),"."]}),"\n"]}),"\n"]}),"\n",(0,n.jsxs)(a.li,{children:["If starting from an existing Pioreactor:","\n",(0,n.jsxs)(a.ol,{children:["\n",(0,n.jsx)(a.li,{children:"with the power off remove the SD card from the Pioreactor and insert it into a computer."}),"\n",(0,n.jsxs)(a.li,{children:["\n",(0,n.jsx)(i,{}),"\n"]}),"\n",(0,n.jsxs)(a.li,{children:["Drag/move the downloaded ",(0,n.jsx)(a.code,{children:"local_access_point"})," file to your SD card (called ",(0,n.jsx)(a.code,{children:"boot"})," or ",(0,n.jsx)(a.code,{children:"bootfs"}),")."]}),"\n",(0,n.jsx)(a.li,{children:"Eject the SD card safely, and put back into the Pioreactor."}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsx)(a.h2,{id:"access-the-local-access-point",children:"Access the local access point"}),"\n",(0,n.jsxs)(a.p,{children:["After plugging in the Pioreactor, the local access point will start and you should see a new network called ",(0,n.jsx)(a.code,{children:"pioreactor"}),", with password ",(0,n.jsx)(a.code,{children:"raspberry"}),". You should be able to connect to this new access point with any computer, phone, tablet, etc."]}),"\n",(0,n.jsx)("img",{src:"/img/user-guide/pioreactor_ap.png",width:"325"}),"\n",(0,n.jsxs)(a.p,{children:["Once connected, the usual urls should work: ",(0,n.jsx)(a.a,{href:"http://pioreactor.local",children:"http://pioreactor.local"})," will bring up the Pioreactor interface (having trouble? Not working? Try our troubleshooting steps below."]}),"\n",(0,n.jsx)(a.admonition,{type:"info",children:(0,n.jsxs)(a.p,{children:["Without access to the internet, the Pioreactor will have the wrong internal time. You can change this ",(0,n.jsx)(a.a,{href:"/user-guide/common-questions#how-do-i-change-the-date-or-time-on-the-pioreactor",children:"using this method"})]})}),"\n",(0,n.jsx)(a.h3,{id:"connecting-more-pioreactors-to-your-local-access-point",children:"Connecting more Pioreactors to your local access point"}),"\n",(0,n.jsx)(a.admonition,{type:"info",children:(0,n.jsxs)(a.p,{children:["Raspberry Pi 3B and Raspberry Pi Zero W have trouble connecting to these local access points. Follow instructions ",(0,n.jsx)(a.a,{href:"https://github.com/Pioreactor/pioreactor/blob/992d986881f3a3504a08b781a494b1a6e3b5a0e3/CHANGELOG.md?plain=1#L110C11-L121",children:"here"}),"."]})}),"\n",(0,n.jsxs)(a.p,{children:["Other Pioreactors will need to be reconfigured to connect to this new access point. During set up in the Raspberry Pi Imager, using the ssid / wifi credentials: ",(0,n.jsx)(a.code,{children:"pioreactor"})," and password ",(0,n.jsx)(a.code,{children:"raspberry"})," in the wireless LAN section. ",(0,n.jsxs)(a.strong,{children:["Don't add the ",(0,n.jsx)(a.code,{children:"local_access_point"})," file to these other Pioreactors - you only need to do that once"]}),"."]}),"\n",(0,n.jsxs)(a.p,{children:["The maximum number of machines (Pioreactors and computers) that can be connected to a local access point on a Pioreactor is ~4-8. There is a possibility to add more, see ",(0,n.jsx)(a.a,{href:"https://github.com/Pioreactor/pioreactor/issues/442",children:"issue here"}),"."]}),"\n",(0,n.jsx)(a.p,{children:"This network may not be connected to the internet, so you won't be able to upgrade any software on the Pioreactors. See section below on how to add internet."}),"\n",(0,n.jsx)(a.h2,{id:"adding-internet-access-to-your-local-access-point",children:"Adding internet access to your local access point"}),"\n",(0,n.jsx)(a.p,{children:"If you are hosting the local access point on a Raspberry Pi that has an ethernet port (B models), you can plug this into a router that has access to the internet to provide internet to your entire cluster."}),"\n",(0,n.jsx)(a.p,{children:(0,n.jsx)(a.img,{alt:"Using the Pioreactor to create a local access point, and the is connected to a router",src:o(8026).Z+"",width:"578",height:"387"})}),"\n",(0,n.jsx)(a.h2,{id:"turning-off-a-local-access-point",children:"Turning off a local access point"}),"\n",(0,n.jsxs)(a.p,{children:["After SSH-ing into your Pioreactor, simply delete the ",(0,n.jsx)(a.code,{children:"local_access_point"})," file in the ",(0,n.jsx)(a.code,{children:"/boot/firmware/"})," directory, and reboot."]}),"\n",(0,n.jsx)(a.h2,{id:"changing-ssid-name-or-password-for-your-local-access-point",children:"Changing SSID name or password for your local access point"}),"\n",(0,n.jsxs)(a.p,{children:["In the ",(0,n.jsx)(a.code,{children:"config.ini"}),", the SSID and password are editable under the section ",(0,n.jsx)(a.code,{children:"local_access_point"}),". This requires a power-cycle to take effect."]}),"\n",(0,n.jsx)(a.h2,{id:"troubleshooting",children:"Troubleshooting"}),"\n",(0,n.jsx)(a.h3,{id:"my-computer-cant-connect-to-the-local-access-point",children:"My computer can't connect to the local-access-point"}),"\n",(0,n.jsxs)(a.h4,{id:"do-you-see-the-pioreactor-network-in-the-list-of-available-wifi-networks",children:["Do you see the ",(0,n.jsx)(a.code,{children:"pioreactor"})," network in the list of available wifi networks?"]}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsx)(a.li,{children:'If presented, use the option "Use security key to connect" (this is an alias for the password).'}),"\n",(0,n.jsx)(a.li,{children:"Try power-cycling your Pioreactor"}),"\n",(0,n.jsxs)(a.li,{children:["The maximum number of machines (Pioreactors and computers) that can be connected to a local access point on a Pioreactor is ~4-8. There is a possibility to add more, see ",(0,n.jsx)(a.a,{href:"https://github.com/Pioreactor/pioreactor/issues/442",children:"issue here"}),"."]}),"\n"]}),"\n",(0,n.jsxs)(a.h4,{id:"alternatively-do-you-not-see-the-pioreactor-network-in-the-list-of-available-wifi-networks",children:["Alternatively, do you ",(0,n.jsx)(a.em,{children:"not"})," see the ",(0,n.jsx)(a.code,{children:"pioreactor"})," network in the list of available wifi networks?"]}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsx)(a.li,{children:"Try power-cycling the Raspberry Pi"}),"\n",(0,n.jsxs)(a.li,{children:["If you unplug the Pioreactor, and place the SD card back into your computer, do you see the ",(0,n.jsx)(a.code,{children:"local_access_point"})," file? If not, try adding the file again, inserting the SD card in the Pioreactor, and restarting the Pioreactor."]}),"\n"]}),"\n",(0,n.jsxs)(a.h3,{id:"im-on-the-network-but-cant-load-the-pioreactor-ui-at-httppioreactorlocal",children:["I'm on the network, but can't load the Pioreactor UI at ",(0,n.jsx)(a.code,{children:"http://pioreactor.local"})]}),"\n",(0,n.jsxs)(a.p,{children:["Try ",(0,n.jsx)(a.code,{children:"http://pioreactor network in the list of available wifi networks?",id:"do-you-see-the-pioreactor-network-in-the-list-of-available-wifi-networks",level:4},{value:"Alternatively, do you not see the pioreactor network in the list of available wifi networks?",id:"alternatively-do-you-not-see-the-pioreactor-network-in-the-list-of-available-wifi-networks",level:4},{value:"I'm on the network, but can't load the Pioreactor UI at http://pioreactor.local",id:"im-on-the-network-but-cant-load-the-pioreactor-ui-at-httppioreactorlocal",level:3},{value:"I can't connect a worker to my local access point",id:"i-cant-connect-a-worker-to-my-local-access-point",level:3},{value:"I'm pretty sure I'm at the limit of ~4-8 clients on my access point - what can I do?",id:"im-pretty-sure-im-at-the-limit-of-4-8-clients-on-my-access-point---what-can-i-do",level:3}];function h(e){const a={a:"a",admonition:"admonition",code:"code",em:"em",h2:"h2",h3:"h3",h4:"h4",img:"img",li:"li",ol:"ol",p:"p",pre:"pre",strong:"strong",ul:"ul",...(0,c.a)(),...e.components};return(0,n.jsxs)(n.Fragment,{children:[(0,n.jsx)(a.p,{children:"For some use cases, you may want to create a local WiFi network just for your Pioreactors (this is called a local access point, or a hotspot). Why might you want to do this?"}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsx)(a.li,{children:"If you want to get started right away, without dealing with exiting WiFi networks."}),"\n",(0,n.jsx)(a.li,{children:"If your usual WiFi network is restrictive (ex: doesn't allow Raspberry Pis, or requires IT support to host them)."}),"\n",(0,n.jsx)(a.li,{children:"If you want to take the Pioreactor, or cluster of Pioreactors, out into the field where there is no network."}),"\n"]}),"\n",(0,n.jsx)(a.p,{children:"The Pioreactor comes with the ability to create its own local access point, which other Pioreactors can connect to. See image below:"}),"\n",(0,n.jsx)(a.p,{children:(0,n.jsx)(a.img,{alt:"Using the Pioreactor to create a local access point",src:o(13726).Z+"",width:"1191",height:"387"})}),"\n",(0,n.jsx)(a.admonition,{type:"info",children:(0,n.jsx)(a.p,{children:"The built-in local access point is meant for small clusters of Pioreactors, and it's range and stability is limited. If you want a proper local access point, we suggest purchasing an inexpensive Wifi router and using that, or a Wifi USB device (the router does not need to be connected to the internet - it will still create a wireless network you can connect Pioreactors to regardless)."})}),"\n",(0,n.jsx)(a.h2,{id:"starting-a-local-access-point",children:"Starting a local access point"}),"\n",(0,n.jsx)(a.p,{children:"The Pioreactor has the necessary software and hardware to create the local access point. To start the access point:"}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsxs)(a.li,{children:["If starting with a new Pioreactor, during software set up:","\n",(0,n.jsxs)(a.ol,{children:["\n",(0,n.jsxs)(a.li,{children:['Leave the "Configure wireless LAN" unchecked. Continue with the instructions at ',(0,n.jsx)(a.a,{href:"/user-guide/software-set-up#setting-up-your-raspberry-pi",children:"Setting up your Raspberry Pi"}),"."]}),"\n",(0,n.jsxs)(a.li,{children:["After the SD card has been written to, remove the SD card from your computer, and immediately insert it back in. A ",(0,n.jsx)(a.code,{children:"boot"})," (or ",(0,n.jsx)(a.code,{children:"bootfs"}),") device should be present now that is your SD card. If asked to reformat the SD card, select NO."]}),"\n",(0,n.jsxs)(a.li,{children:["\n",(0,n.jsx)(i,{}),"\n"]}),"\n",(0,n.jsxs)(a.li,{children:["Drag/move the downloaded ",(0,n.jsx)(a.code,{children:"local_access_point"})," file to the SD card directory."]}),"\n",(0,n.jsxs)(a.li,{children:["Eject the SD card safely, and continue with instructions at ",(0,n.jsx)(a.a,{href:"/user-guide/software-set-up#setting-up-your-raspberry-pi",children:"Setting up your Raspberry Pi"}),"."]}),"\n"]}),"\n"]}),"\n",(0,n.jsxs)(a.li,{children:["If starting from an existing Pioreactor:","\n",(0,n.jsxs)(a.ol,{children:["\n",(0,n.jsx)(a.li,{children:"with the power off remove the SD card from the Pioreactor and insert it into a computer."}),"\n",(0,n.jsxs)(a.li,{children:["\n",(0,n.jsx)(i,{}),"\n"]}),"\n",(0,n.jsxs)(a.li,{children:["Drag/move the downloaded ",(0,n.jsx)(a.code,{children:"local_access_point"})," file to your SD card (called ",(0,n.jsx)(a.code,{children:"boot"})," or ",(0,n.jsx)(a.code,{children:"bootfs"}),")."]}),"\n",(0,n.jsx)(a.li,{children:"Eject the SD card safely, and put back into the Pioreactor."}),"\n"]}),"\n"]}),"\n"]}),"\n",(0,n.jsx)(a.h2,{id:"access-the-local-access-point",children:"Access the local access point"}),"\n",(0,n.jsxs)(a.p,{children:["After plugging in the Pioreactor, the local access point will start and you should see a new network called ",(0,n.jsx)(a.code,{children:"pioreactor"}),", with password ",(0,n.jsx)(a.code,{children:"raspberry"}),". You should be able to connect to this new access point with any computer, phone, tablet, etc."]}),"\n",(0,n.jsx)("img",{src:"/img/user-guide/pioreactor_ap.png",width:"325"}),"\n",(0,n.jsxs)(a.p,{children:["Once connected, the usual urls should work: ",(0,n.jsx)(a.a,{href:"http://pioreactor.local",children:"http://pioreactor.local"})," will bring up the Pioreactor interface (having trouble? Not working? Try our troubleshooting steps below."]}),"\n",(0,n.jsx)(a.admonition,{type:"info",children:(0,n.jsxs)(a.p,{children:["Without access to the internet, the Pioreactor will have the wrong internal time. You can change this ",(0,n.jsx)(a.a,{href:"/user-guide/common-questions#how-do-i-change-the-date-or-time-on-the-pioreactor",children:"using this method"})]})}),"\n",(0,n.jsx)(a.h3,{id:"connecting-more-pioreactors-to-your-local-access-point",children:"Connecting more Pioreactors to your local access point"}),"\n",(0,n.jsx)(a.admonition,{type:"info",children:(0,n.jsxs)(a.p,{children:["Raspberry Pi 3B (not B+) and Raspberry Pi Zero W (not Zero 2) have trouble connecting to these local access points. Follow instructions ",(0,n.jsx)(a.a,{href:"https://github.com/Pioreactor/pioreactor/blob/992d986881f3a3504a08b781a494b1a6e3b5a0e3/CHANGELOG.md?plain=1#L110C11-L121",children:"here"}),"."]})}),"\n",(0,n.jsxs)(a.p,{children:["Other Pioreactors will need to be reconfigured to connect to this new access point. During set up in the Raspberry Pi Imager, using the ssid / wifi credentials: ",(0,n.jsx)(a.code,{children:"pioreactor"})," and password ",(0,n.jsx)(a.code,{children:"raspberry"})," in the wireless LAN section. ",(0,n.jsxs)(a.strong,{children:["Don't add the ",(0,n.jsx)(a.code,{children:"local_access_point"})," file to these other Pioreactors - you only need to do that once"]}),"."]}),"\n",(0,n.jsxs)(a.p,{children:["The maximum number of machines (Pioreactors and computers) that can be connected to a local access point on a Pioreactor is ~4-8. There is a possibility to add more, see ",(0,n.jsx)(a.a,{href:"https://github.com/Pioreactor/pioreactor/issues/442",children:"issue here"}),"."]}),"\n",(0,n.jsx)(a.p,{children:"This network may not be connected to the internet, so you won't be able to upgrade any software on the Pioreactors. See section below on how to add internet."}),"\n",(0,n.jsx)(a.h2,{id:"adding-internet-access-to-your-local-access-point",children:"Adding internet access to your local access point"}),"\n",(0,n.jsx)(a.p,{children:"If you are hosting the local access point on a Raspberry Pi that has an ethernet port (B models, or via a usb-ethernet gadget), you can plug this into a router that has access to the internet to provide internet to your entire cluster."}),"\n",(0,n.jsx)(a.p,{children:(0,n.jsx)(a.img,{alt:"Using the Pioreactor to create a local access point, and the is connected to a router",src:o(8026).Z+"",width:"578",height:"387"})}),"\n",(0,n.jsx)(a.h2,{id:"turning-off-a-local-access-point",children:"Turning off a local access point"}),"\n",(0,n.jsxs)(a.p,{children:["After SSH-ing into your Pioreactor, simply delete the ",(0,n.jsx)(a.code,{children:"local_access_point"})," file in the ",(0,n.jsx)(a.code,{children:"/boot/firmware/"})," directory, and reboot."]}),"\n",(0,n.jsx)(a.pre,{children:(0,n.jsx)(a.code,{children:"sudo rm /boot/firmware/local_access_point\n"})}),"\n",(0,n.jsx)(a.h2,{id:"changing-ssid-name-or-password-for-your-local-access-point",children:"Changing SSID name or password for your local access point"}),"\n",(0,n.jsxs)(a.p,{children:["In the ",(0,n.jsx)(a.code,{children:"config.ini"}),", the SSID and password are editable under the section ",(0,n.jsx)(a.code,{children:"local_access_point"}),". This requires a power-cycle to take effect, and any other workers in the cluster will need to be updated."]}),"\n",(0,n.jsx)(a.h2,{id:"troubleshooting",children:"Troubleshooting"}),"\n",(0,n.jsx)(a.h3,{id:"my-computer-cant-connect-to-the-local-access-point",children:"My computer can't connect to the local-access-point"}),"\n",(0,n.jsxs)(a.h4,{id:"do-you-see-the-pioreactor-network-in-the-list-of-available-wifi-networks",children:["Do you see the ",(0,n.jsx)(a.code,{children:"pioreactor"})," network in the list of available wifi networks?"]}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsx)(a.li,{children:'If presented, use the option "Use security key to connect" (this is an alias for the password).'}),"\n",(0,n.jsx)(a.li,{children:"Try power-cycling your Pioreactor"}),"\n",(0,n.jsxs)(a.li,{children:["The maximum number of machines (Pioreactors and computers) that can be connected to a local access point on a Pioreactor is ~4-8. There is a possibility to add more, see ",(0,n.jsx)(a.a,{href:"https://github.com/Pioreactor/pioreactor/issues/442",children:"issue here"}),"."]}),"\n"]}),"\n",(0,n.jsxs)(a.h4,{id:"alternatively-do-you-not-see-the-pioreactor-network-in-the-list-of-available-wifi-networks",children:["Alternatively, do you ",(0,n.jsx)(a.em,{children:"not"})," see the ",(0,n.jsx)(a.code,{children:"pioreactor"})," network in the list of available wifi networks?"]}),"\n",(0,n.jsxs)(a.ul,{children:["\n",(0,n.jsx)(a.li,{children:"Try power-cycling the Raspberry Pi"}),"\n",(0,n.jsxs)(a.li,{children:["If you unplug the Pioreactor, and place the SD card back into your computer, do you see the ",(0,n.jsx)(a.code,{children:"local_access_point"})," file? If not, try adding the file again, inserting the SD card in the Pioreactor, and restarting the Pioreactor."]}),"\n"]}),"\n",(0,n.jsxs)(a.h3,{id:"im-on-the-network-but-cant-load-the-pioreactor-ui-at-httppioreactorlocal",children:["I'm on the network, but can't load the Pioreactor UI at ",(0,n.jsx)(a.code,{children:"http://pioreactor.local"})]}),"\n",(0,n.jsxs)(a.p,{children:["Try ",(0,n.jsx)(a.code,{children:"http://Your Docusaurus site did not load properly.
\nA very common reason is a wrong site baseUrl configuration.
\nCurrent configured baseUrl = ${e} ${"/"===e?" (default value)":""}
\nWe suggest trying baseUrl =
\n.comment can become .namespace--comment) or replace them with your defined ones (like .editor__comment). You can even add new classes.",owner:"dvkndn",noCSS:!0},"file-highlight":{title:"File Highlight",description:"Fetch external files and highlight them with Prism. Used on the Prism website itself.",noCSS:!0},"show-language":{title:"Show Language",description:"Display the highlighted language in code blocks (inline code does not show the label).",owner:"nauzilus",noCSS:!0,require:"toolbar"},"jsonp-highlight":{title:"JSONP Highlight",description:"Fetch content with JSONP and highlight some interesting content (e.g. GitHub/Gists or Bitbucket API).",noCSS:!0,owner:"nauzilus"},"highlight-keywords":{title:"Highlight Keywords",description:"Adds special CSS classes for each keyword for fine-grained highlighting.",owner:"vkbansal",noCSS:!0},"remove-initial-line-feed":{title:"Remove initial line feed",description:"Removes the initial line feed in code blocks.",owner:"Golmote",noCSS:!0},"inline-color":{title:"Inline color",description:"Adds a small inline preview for colors in style sheets.",require:"css-extras",owner:"RunDevelopment"},previewers:{title:"Previewers",description:"Previewers for angles, colors, gradients, easing and time.",require:"css-extras",owner:"Golmote"},autoloader:{title:"Autoloader",description:"Automatically loads the needed languages to highlight the code blocks.",owner:"Golmote",noCSS:!0},"keep-markup":{title:"Keep Markup",description:"Prevents custom markup from being dropped out during highlighting.",owner:"Golmote",optional:"normalize-whitespace",noCSS:!0},"command-line":{title:"Command Line",description:"Display a command line with a prompt and, optionally, the output/response from the commands.",owner:"chriswells0"},"unescaped-markup":{title:"Unescaped Markup",description:"Write markup without having to escape anything."},"normalize-whitespace":{title:"Normalize Whitespace",description:"Supports multiple operations to normalize whitespace in code blocks.",owner:"zeitgeist87",optional:"unescaped-markup",noCSS:!0},"data-uri-highlight":{title:"Data-URI Highlight",description:"Highlights data-URI contents.",owner:"Golmote",noCSS:!0},toolbar:{title:"Toolbar",description:"Attach a toolbar for plugins to easily register buttons on the top of a code block.",owner:"mAAdhaTTah"},"copy-to-clipboard":{title:"Copy to Clipboard Button",description:"Add a button that copies the code block to the clipboard when clicked.",owner:"mAAdhaTTah",require:"toolbar",noCSS:!0},"download-button":{title:"Download Button",description:"A button in the toolbar of a code block adding a convenient way to download a code file.",owner:"Golmote",require:"toolbar",noCSS:!0},"match-braces":{title:"Match braces",description:"Highlights matching braces.",owner:"RunDevelopment"},"diff-highlight":{title:"Diff Highlight",description:"Highlights the code inside diff blocks.",owner:"RunDevelopment",require:"diff"},"filter-highlight-all":{title:"Filter highlightAll",description:"Filters the elements the highlightAll and highlightAllUnder methods actually highlight.",owner:"RunDevelopment",noCSS:!0},treeview:{title:"Treeview",description:"A language with special styles to highlight file system tree structures.",owner:"Golmote"}}})},2885:(e,t,n)=>{const r=n(29901),a=n(39642),o=new Set;function i(e){void 0===e?e=Object.keys(r.languages).filter((e=>"meta"!=e)):Array.isArray(e)||(e=[e]);const t=[...o,...Object.keys(Prism.languages)];a(r,e,t).load((e=>{if(!(e in r.languages))return void(i.silent||console.warn("Language does not exist: "+e));const t="./prism-"+e;delete n.c[n(16500).resolve(t)],delete Prism.languages[e],n(16500)(t),o.add(e)}))}i.silent=!1,e.exports=i},96854:()=>{!function(e){function t(e,t){return"___"+e.toUpperCase()+t+"___"}Object.defineProperties(e.languages["markup-templating"]={},{buildPlaceholders:{value:function(n,r,a,o){if(n.language===r){var i=n.tokenStack=[];n.code=n.code.replace(a,(function(e){if("function"==typeof o&&!o(e))return e;for(var a,s=i.length;-1!==n.code.indexOf(a=t(r,s));)++s;return i[s]=e,a})),n.grammar=e.languages.markup}}},tokenizePlaceholders:{value:function(n,r){if(n.language===r&&n.tokenStack){n.grammar=e.languages[r];var a=0,o=Object.keys(n.tokenStack);!function i(s){for(var l=0;lYour Docusaurus site did not load properly.
\nA very common reason is a wrong site baseUrl configuration.
\nCurrent configured baseUrl = ${e} ${"/"===e?" (default value)":""}
\nWe suggest trying baseUrl =
\n.comment can become .namespace--comment) or replace them with your defined ones (like .editor__comment). You can even add new classes.",owner:"dvkndn",noCSS:!0},"file-highlight":{title:"File Highlight",description:"Fetch external files and highlight them with Prism. Used on the Prism website itself.",noCSS:!0},"show-language":{title:"Show Language",description:"Display the highlighted language in code blocks (inline code does not show the label).",owner:"nauzilus",noCSS:!0,require:"toolbar"},"jsonp-highlight":{title:"JSONP Highlight",description:"Fetch content with JSONP and highlight some interesting content (e.g. GitHub/Gists or Bitbucket API).",noCSS:!0,owner:"nauzilus"},"highlight-keywords":{title:"Highlight Keywords",description:"Adds special CSS classes for each keyword for fine-grained highlighting.",owner:"vkbansal",noCSS:!0},"remove-initial-line-feed":{title:"Remove initial line feed",description:"Removes the initial line feed in code blocks.",owner:"Golmote",noCSS:!0},"inline-color":{title:"Inline color",description:"Adds a small inline preview for colors in style sheets.",require:"css-extras",owner:"RunDevelopment"},previewers:{title:"Previewers",description:"Previewers for angles, colors, gradients, easing and time.",require:"css-extras",owner:"Golmote"},autoloader:{title:"Autoloader",description:"Automatically loads the needed languages to highlight the code blocks.",owner:"Golmote",noCSS:!0},"keep-markup":{title:"Keep Markup",description:"Prevents custom markup from being dropped out during highlighting.",owner:"Golmote",optional:"normalize-whitespace",noCSS:!0},"command-line":{title:"Command Line",description:"Display a command line with a prompt and, optionally, the output/response from the commands.",owner:"chriswells0"},"unescaped-markup":{title:"Unescaped Markup",description:"Write markup without having to escape anything."},"normalize-whitespace":{title:"Normalize Whitespace",description:"Supports multiple operations to normalize whitespace in code blocks.",owner:"zeitgeist87",optional:"unescaped-markup",noCSS:!0},"data-uri-highlight":{title:"Data-URI Highlight",description:"Highlights data-URI contents.",owner:"Golmote",noCSS:!0},toolbar:{title:"Toolbar",description:"Attach a toolbar for plugins to easily register buttons on the top of a code block.",owner:"mAAdhaTTah"},"copy-to-clipboard":{title:"Copy to Clipboard Button",description:"Add a button that copies the code block to the clipboard when clicked.",owner:"mAAdhaTTah",require:"toolbar",noCSS:!0},"download-button":{title:"Download Button",description:"A button in the toolbar of a code block adding a convenient way to download a code file.",owner:"Golmote",require:"toolbar",noCSS:!0},"match-braces":{title:"Match braces",description:"Highlights matching braces.",owner:"RunDevelopment"},"diff-highlight":{title:"Diff Highlight",description:"Highlights the code inside diff blocks.",owner:"RunDevelopment",require:"diff"},"filter-highlight-all":{title:"Filter highlightAll",description:"Filters the elements the highlightAll and highlightAllUnder methods actually highlight.",owner:"RunDevelopment",noCSS:!0},treeview:{title:"Treeview",description:"A language with special styles to highlight file system tree structures.",owner:"Golmote"}}})},2885:(e,t,n)=>{const r=n(29901),a=n(39642),o=new Set;function i(e){void 0===e?e=Object.keys(r.languages).filter((e=>"meta"!=e)):Array.isArray(e)||(e=[e]);const t=[...o,...Object.keys(Prism.languages)];a(r,e,t).load((e=>{if(!(e in r.languages))return void(i.silent||console.warn("Language does not exist: "+e));const t="./prism-"+e;delete n.c[n(16500).resolve(t)],delete Prism.languages[e],n(16500)(t),o.add(e)}))}i.silent=!1,e.exports=i},96854:()=>{!function(e){function t(e,t){return"___"+e.toUpperCase()+t+"___"}Object.defineProperties(e.languages["markup-templating"]={},{buildPlaceholders:{value:function(n,r,a,o){if(n.language===r){var i=n.tokenStack=[];n.code=n.code.replace(a,(function(e){if("function"==typeof o&&!o(e))return e;for(var a,s=i.length;-1!==n.code.indexOf(a=t(r,s));)++s;return i[s]=e,a})),n.grammar=e.languages.markup}}},tokenizePlaceholders:{value:function(n,r){if(n.language===r&&n.tokenStack){n.grammar=e.languages[r];var a=0,o=Object.keys(n.tokenStack);!function i(s){for(var l=0;l