add russian placholders and config
This commit is contained in:
n8fr8
parent
384af2d663
commit
5ce1b4e60b
35 changed files with 1620 additions and 1 deletions
|
|
@ -0,0 +1,8 @@
|
|||
{
|
||||
"label": "Raspberry Pi",
|
||||
"position": 1,
|
||||
"link": {
|
||||
"type": "doc",
|
||||
"id": "build-a-box/raspberry-pi/index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,35 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
# Basic Box Supplies
|
||||
|
||||
A basic Butter Box setup is a Raspberry Pi Zero 2 W with a microSD card running the Butter software, a USB stick, powered by a USB source like a power cord, power bank or solar panel.
|
||||
|
||||
In most setups like this, a Butter Box can comfortably handle **4–10 connected devices at once** without slowing down. It’s possible to have more, but performance may drop if everyone is downloading large files or videos at the same time.
|
||||
|
||||
The reach for it is about **5–10 meters** indoors, depending on the Raspberry Pi model and depending on walls and interference. Outdoors, in open space, it can sometimes reach farther. Think of it like the range of a home Wi-Fi router — enough to cover a classroom, a coffee shop, meeting space, or small outdoor gathering.
|
||||
|
||||
## Supplies
|
||||
|
||||
* [ ] Raspberry Pi Zero 2W (64 Bit) [https://www.adafruit.com/product/5291](https://www.adafruit.com/product/5291); Or you can buy a kit here: [\
|
||||
https://www.canakit.com/raspberry-pi-zero-2-w.html](https://www.canakit.com/raspberry-pi-zero-2-w.html)
|
||||
* [ ] Power outlet and power cord that accompanies the Raspberry Pi Zero 2W or an [alternative power supply](../power-supply)
|
||||
* [ ] Micro SD Card: Images with the Butter software are usually under 16 GB (we suggest 256 GB). Media that people upload to the chat ends up on the card; it never gets cleared.
|
||||
* [ ] USB drive (min 32 GB)
|
||||
* [ ] Adapters (as needed)
|
||||
|
||||
* [ ] Micro USB/Male to USB A/Female
|
||||
* [ ] A dongle to connect the micro SD card to your laptop (if needed)
|
||||
|
||||
|
||||
|
||||
**Once you have your supplies, continue in the Install Butter section.**
|
||||
|
||||
[install-butter.md](install-butter)
|
||||
|
||||
<figure><img src="/img/docs/20250815_142828.jpg" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -0,0 +1,49 @@
|
|||
---
|
||||
description: How To Add a Router To Your Box Setup
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Extend Your Box
|
||||
|
||||
An extended Butter Box pairs the Raspberry Pi with a standalone Wi-Fi router, giving stronger signal and more simultaneous connections.
|
||||
|
||||
With the router, the network can reach 10-30 m (32-98 feet),and can comfortably support 10–20 connected devices at the same time. This setup is ideal for a medium group of people in a medium room, like classrooms, events, or community spaces.
|
||||
|
||||
## Supplies
|
||||
|
||||
* [ ] Raspberry Pi 4, 5 or Raspberry Pi Zero 2W
|
||||
* [ ] Router ([Opal (GL-SFT1200) Wireless Travel Router](https://store-us.gl-inet.com/products/united-states-opal-gl-sft1200-gigabit-wireless-router-dual-band-openwrt-ipv6-tor) or equivilent)
|
||||
* [ ] Power outlet and power cords that accompany the Raspberry Pi and the Router or an [alternative power supply](../power-supply)
|
||||
* [ ] Micro SD Card: Images with the Butter software are usually under 16 GB (we suggest 256 GB). Media that people upload to the chat ends up on the card; it never gets cleared.
|
||||
* [ ] USB Drive (min 32 GB)
|
||||
* [ ] Adapters (as needed)
|
||||
|
||||
_No internet connection is required._
|
||||
|
||||
<figure><img src="/img/docs/20250815_142438.jpg" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
|
||||
## Steps
|
||||
|
||||
To extend your box, you simply connect a GLi-Net router to the Butter Box with an ethernet cable. Instead of accessing the box from the portal Wi-Fi hotspot (eg. 'butter box' or whichever name you set in the admin settings), users will join the Wi-Fi network of the router.
|
||||
|
||||
### Connect the Butter Box to its power supply.
|
||||
|
||||
Connect the Butter Box to power.
|
||||
|
||||
### Connect Router
|
||||
|
||||
Connect the router to power. Then use the ethernet cable to connect to the Butter Box. Make sure to plug the Ethernet cable into the LAN port on your router.
|
||||
|
||||
### Test Your Connection
|
||||
|
||||
Join the router Wi-Fi. If you have not setup or used this router before, enter the default password found in the user guide included in the package. After 30 seconds, open http://butterbox.local in a browser.
|
||||
|
||||
### Disable Butter Box Wi-Fi Access Point
|
||||
|
||||
Open the admin settings from the Butter Box portal. Navigate to **Secure Portal**. Turn off the Wi-Fi access point. This will hide the Wi-Fi network that broadcasts from the raspberry pi, so that users don’t get confused about which network to join.
|
||||
|
||||
### Invite Users to Join the Router Wi-Fi
|
||||
|
||||
Users will now join the Wi-Fi network of the router when they want to connect to the Butter Box.
|
||||
|
|
@ -0,0 +1,5 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Raspberry Pi
|
||||
|
||||
|
|
@ -0,0 +1,88 @@
|
|||
---
|
||||
description: Install Butter Operating System (OS) on an SD card for Raspberry Pi
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Install Butter
|
||||
|
||||
You will need:
|
||||
|
||||
* Desktop computer
|
||||
* Internet Connection
|
||||
* Butter Box
|
||||
|
||||
### Download the Butter OS for Raspberry Pi
|
||||
|
||||
Make sure the file size matches the size listed on the website. Sometimes browsers do not complete the download, which can result in a corrupted file.
|
||||
|
||||
[https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0](https://www.dropbox.com/scl/fo/helpqh3q2oj7ti2ia038m/h?dl=0.&rlkey=cswt4w4zksiuj3eb1oca48yw0)
|
||||
|
||||
:::info
|
||||
Always choose the Latest Version of the file.
|
||||
:::
|
||||
|
||||
### Plug the micro SD card into your computer
|
||||
|
||||
To plug the micro SD card into your computer, you may need an adapter to do this:
|
||||
|
||||
<div align="center"><figure><img src="/img/docs/image (1).png" alt="" width="375"/><figcaption><p>Example adapter (USB-C to Micro SD)</p></figcaption></figure></div>
|
||||
|
||||
:::info
|
||||
You don't need to connect the box to the computer.
|
||||
:::
|
||||
|
||||
### Run Raspberry Pi Imager
|
||||
|
||||
Once you have your micro SD card plugged into your computer that has an internet connection, run Raspberry Pi Imager from a desktop computer. It will walk you through the steps to install the Butter operating system on the micro SD card.
|
||||
|
||||
If you don't have Raspberry Pi Imager, you can download it here: [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)
|
||||
|
||||
### Choose device > **Raspberry Pi Zero 2 W**
|
||||
|
||||
Once the Raspberry Pi Image starts, you will be prompt to select your Raspberry Pi device.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 9.56.27 AM.png" alt=""/><figcaption><p>Select Raspberry Pi Zero 2 W (or the device you have if it's not the standard box from Butter HQ)</p></figcaption></figure>
|
||||
|
||||
### Choose Operating System > Use Custom
|
||||
|
||||
* On the OS tab, select **Use custom** and upload the custom Butter OS .img file. Confirm that you have **unzipped the file** before using it.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 9.57.31 AM.png" alt=""/><figcaption><p>Select Use Custom. You will upload the custom .img file that you downloaded from Dropbox.</p></figcaption></figure>
|
||||
|
||||
### Choose Storage > Select Micro SD Card
|
||||
|
||||
* From the **Storage** tab, select the **Micro SD Card.**
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.27.37 PM.png" alt=""/><figcaption><p>Select the Micro SD Card.</p></figcaption></figure>
|
||||
|
||||
Your screen will look similar to this after all selections:
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.27.43 PM.png" alt=""/><figcaption><p>Final screen after selections.</p></figcaption></figure>
|
||||
|
||||
You may be prompt with _"Doing this will erase all data from selected external storage"_ and “_do you want to apply settings”_, click then on _“no clear settings”_.
|
||||
|
||||
After that select _"write"_ and begin writing process to the Micro SD card.
|
||||
|
||||
### Remove From Computer and Insert Micro SD Card into the Raspberry Pi (Butter Box)
|
||||
|
||||
Once you're done, remove the Micro SD card. Insert the Micro SD card into the Raspberry Pi (Butter Box) not powered on.
|
||||
|
||||
### Go to Quick Start
|
||||
|
||||
Plug the Raspberry Pi (Butter Box) into power. Wait a few moments and connect to the Butter Box Portal. Go to the [Quick Start](../../quick-start) section for more details.
|
||||
|
||||
**If you are building an extended box, continue in the next section: Extend Your Box.**
|
||||
|
||||
[extend-your-box.md](extend-your-box)
|
||||
|
||||
|
||||
|
||||
### Troubleshooting
|
||||
|
||||
If you see an error stating that the input file is not a valid disk image, check the file you downloaded.
|
||||
|
||||
Make sure the file size matches the size listed on the website. Sometimes browsers do not complete the download, which can result in a corrupted file.
|
||||
|
||||
Also confirm that you have **unzipped the file** before using it.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.28.37 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
|
@ -0,0 +1,15 @@
|
|||
---
|
||||
description: Different ways to power your Butter Box
|
||||
---
|
||||
|
||||
# Power Supply
|
||||
|
||||
If you want Butter to work completely off-grid and without electricity, it can! Butter Boxes can be powered by a wall outlet, pre-charged battery pack or solar powered battery pack.
|
||||
|
||||
* **Wall Outlet:** The official and recommended power supply for Raspberry Pi computers (depends of the Raspberry Pi model that you are using)
|
||||
* **Pre-charged Battery Pack (Power Bank):** This is the most common option for field use.
|
||||
* Anker portable charger [power bank](https://www.amazon.com/Anker-Portable-PowerCore-High-Speed-Charging/dp/B09VXF29RM/ref=sr_1_6?crid=30EJM6E540GE6\&dib=eyJ2IjoiMSJ9.cMM86su3KXjp8lN7z7mvmL1HERSowjwoegVu1E_8xhH-Pl38rDD2hEv21fVqk-w2eogpdZGsfiLn_V8ij-PvaRw3RDBdv9-NTKTFqGOUj6IZJKMdbeUjGkgBFVFdZvyOkBFF6kau0uJIE-rRQyseWiNNPxZwan-29xuz2_f643gTOfOzERBuVK2cDdpm91rPdVsRl3dKy6iR1K7qkYW5YGTtYpaZWriYGWOovD2CcVA.SogXwrCYRlPyAkf0wzwye8_-ZdVw-Fi0EcM5vcr7ESk\&dib_tag=se\&keywords=anker%2Bpower%2Bbank%2Bbattery%2Bpack%2Bwhite\&qid=1756265405\&sprefix=anker%2Bpower%2Bbank%2Bbattery%2Bpack%2Bwhit%2Caps%2C154\&sr=8-6\&th=1)
|
||||
* **Solar Panel (with Power Bank):** Use a small solar panel to recharge your power bank. This is a good option to keep the box running continuously in off-grid locations. Using direct solar panel without a battery is possible, but unstable if the sun dips in/out.
|
||||
* Solar panel kits: [https://voltaicsystems.com/solar-panel-kits/](https://voltaicsystems.com/solar-panel-kits/)
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-07-31 at 10.55.41 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
Loading…
Add table
Add a link
Reference in a new issue