add spanish
This commit is contained in:
n8fr8
parent
2ac53d2ebe
commit
4d86d9b7e8
29 changed files with 1141 additions and 0 deletions
|
|
@ -0,0 +1,8 @@
|
|||
{
|
||||
"label": "Build A Box",
|
||||
"position": 3,
|
||||
"link": {
|
||||
"type": "doc",
|
||||
"id": "build-a-box/index"
|
||||
}
|
||||
}
|
||||
|
|
@ -0,0 +1,20 @@
|
|||
---
|
||||
description: DIY instructions
|
||||
---
|
||||
|
||||
# Build A Box
|
||||
|
||||
Don’t have a Butter Box yet? You can easily build your own. Choose your setup to get started.
|
||||
|
||||
## Butter Box Setups
|
||||
|
||||
Butter Box software currently runs on Raspberry Pi devices: Pi Zero 2 and Pi 4. You can use either one. See comparison chart below for details.
|
||||
|
||||
| Device | Capacity | Supplies |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------- |
|
||||
| <p><strong>Basic</strong> </p><p>Raspberry Pi Zero Pi 2<br/><br/><a href="raspberry-pi/basic-box-supplies">Get Started</a></p> | Up to 10 people, About 10 meters apart | [Supply List](raspberry-pi/basic-box-supplies) |
|
||||
| <p><strong>Extended</strong> </p><p>Raspberry Pi 4 + Router<br/><br/><a href="raspberry-pi/extend-your-box">Get Started</a></p> | Up to 20 people, About 30 meters apart when paired with a router | [Supply List](raspberry-pi/extend-your-box) |
|
||||
| PC/Laptop (amd64) | _Coming soon_ | _Coming soon_ |
|
||||
|
||||
We also make and ship Butter Boxes to partners worldwide. If you serve a community that could benefit, we’d love to hear from you.
|
||||
|
||||
|
|
@ -0,0 +1,50 @@
|
|||
---
|
||||
description: How to turn an old PC into golden deliciuos butter!
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# PC/Laptop Support (BETA!)
|
||||
|
||||
An important new development for the ButterBox project is the ability to turn any Intel or AMD 64-bit PC into a ButterBox. In many places in the world, getting access to an official RaspberryPi is difficult and expensive. However, no matter where you are in the world, there seem to be plenty of "old", unloved, discarded PC towers and laptops.
|
||||
|
||||
This page will help you bring new life to that old tech, by turning it into the best kind of buttery local microserver, that even has a built-in battery, screen and keyboard!
|
||||
|
||||
## Download the Image
|
||||
|
||||
Access to new images of ButterBox built for Intel/AMD64 devices are now available IN EARLY BETA through our [development image distribution site](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list). Download the latest image that beings with "amd64_butter_main_".
|
||||
|
||||
## How to Flash
|
||||
|
||||
This image can be flashed to a bootable USB drives, using [balenaEtcher](https://etcher.balena.io/).
|
||||
|
||||
1. Install balenaEtcher
|
||||
2. Download the AMD64 image and unpack it (remove .tar and .gz with "unzip" tool)
|
||||
3. Select the image file in balenaEtcher
|
||||
4. Plugin the USB flash drive
|
||||
5. Select the drive in balenaEtcher
|
||||
6. Flash!
|
||||
|
||||
## How to Boot Up
|
||||
|
||||
Once the USB drive is flashed, you can now use it to boot up ButterBox on your old PC.
|
||||
|
||||
1. Boot your old PC into the "BIOS" screen. Make sure it is configured to allow for booting from the USB drive, before it boots the internal hard drive.
|
||||
2. Shutdown the PC.
|
||||
3. Plug in the USB drive to the PC
|
||||
4. Start the PC, and make sure it boots from the USB drive.
|
||||
5. Wait for the login terminal to appear!
|
||||
|
||||
## How to Access
|
||||
|
||||
Once the ButterBox PC is booted up, and plugged into a local router, it should be ready to access!
|
||||
|
||||
Connect your personal device to the same network, and try to access [http://butterbox.local](http://butterbox.local)
|
||||
|
||||
## Differences from RaspberryPi edition
|
||||
|
||||
There are some important differences between ButterBox on PC versus on RaspberryPi
|
||||
|
||||
- There is no built-in wifi hotspot. You must plug it into a dedicated wifi router or network.
|
||||
- You can easily access the terminal "root" user to update and configured (with great power, comes great responsibility!)
|
||||
|
||||
|
||||
|
|
@ -0,0 +1,16 @@
|
|||
---
|
||||
description: Different ways to power your Butter Box
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# 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>
|
||||
|
|
@ -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