Compare commits
No commits in common. "2b5f888d4404510ffec75fc7fc85ef4f330b89cd" and "29237908d714c3e9499dc9954bdc9994392a53cd" have entirely different histories.
2b5f888d44
...
29237908d7
103 changed files with 952 additions and 3314 deletions
20
README.md
20
README.md
|
|
@ -18,29 +18,19 @@ Key files for localization are:
|
|||
### Locale commands
|
||||
|
||||
To update translation key values:
|
||||
|
||||
`npm run write-translations -- --locale <locale>`
|
||||
|
||||
By default, write-translate only appends new values. To also update existing values:
|
||||
- Note this will overwrite **all** JSON stored translations to English.
|
||||
|
||||
`docusaurus write-translations --locale <locale> --overrride`
|
||||
npm run write-translations -- --locale <locale>
|
||||
|
||||
To updated po4a consolidated .pot and .po files from English markdown files (with po4a tool installed):
|
||||
|
||||
`po4a po4a.conf --no-translations`
|
||||
po4a po4a.conf --no-translations
|
||||
|
||||
To update localization markdown files from po4a consolidated .po files (with po4a tool installed):
|
||||
|
||||
`po4a po4a.conf --no-update`
|
||||
po4a po4a.conf --no-update
|
||||
|
||||
To run the site in a specific locale:
|
||||
|
||||
`npm run start -- --locale <locale>`
|
||||
npm run start -- --locale <locale>
|
||||
|
||||
To build the static site for all locales:
|
||||
|
||||
`npm run build`
|
||||
npm run build
|
||||
|
||||
### Localization mapping
|
||||
|
||||
|
|
|
|||
41
README2.md
Normal file
41
README2.md
Normal file
|
|
@ -0,0 +1,41 @@
|
|||
# Website
|
||||
|
||||
This website is built using [Docusaurus](https://docusaurus.io/), a modern static website generator.
|
||||
|
||||
## Installation
|
||||
|
||||
```bash
|
||||
yarn
|
||||
```
|
||||
|
||||
## Local Development
|
||||
|
||||
```bash
|
||||
yarn start
|
||||
```
|
||||
|
||||
This command starts a local development server and opens up a browser window. Most changes are reflected live without having to restart the server.
|
||||
|
||||
## Build
|
||||
|
||||
```bash
|
||||
yarn build
|
||||
```
|
||||
|
||||
This command generates static content into the `build` directory and can be served using any static contents hosting service.
|
||||
|
||||
## Deployment
|
||||
|
||||
Using SSH:
|
||||
|
||||
```bash
|
||||
USE_SSH=true yarn deploy
|
||||
```
|
||||
|
||||
Not using SSH:
|
||||
|
||||
```bash
|
||||
GIT_USER=<Your GitHub username> yarn deploy
|
||||
```
|
||||
|
||||
If you are using GitHub pages for hosting, this command is a convenient way to build the website and push to the `gh-pages` branch.
|
||||
|
|
@ -1,32 +0,0 @@
|
|||
---
|
||||
slug: final-report
|
||||
title: RCBox + ExtendEast - Final Report
|
||||
authors: [nxf99]
|
||||
tags: []
|
||||
---
|
||||
|
||||
**Executive Summary**
|
||||
|
||||
This report covers our second major deliverable for the RCBox “Extend East” program running from December 2025 through the end of March 2026 funded by OTF. The first project deliverable was focused on Objective 1, which was to onboard and develop an overall work plan for the project with our regional partners. This also included user research and threat modeling, all of which were completed and reported on in January 2026. This work helped guide the rest of the program to a successful completion.
|
||||
This deliverable report covers the outcomes and outputs of the remaining Objectives 2 through 6, all of which were successfully completed. Details of each Objective, Deliverable, and Outcome are provided in our “Objectives & Outcomes” table below.
|
||||
|
||||
|
||||
The major technical highlights achieved were a complete overhaul of the “portal” user interface and admin panel, the successful coexistence and communication between multiple RCBox instances, the addition of support for fully offline delay-tolerant secure messaging (DeltaChat!) between one or more of those boxes, and the successful test of Wifi HaLow radios with IP routing to extend the physical range and number of RCBox instances for viable communication.
|
||||
|
||||
|
||||
Through our collaboration with the regional partner, we successfully tuned the solution to better meet their needs and threat models, while collaborating to produce new localized documentation and content packs.
|
||||
|
||||
|
||||
**Overall key achievements included:**
|
||||
|
||||
- User Interface & Localization: A new portal UI was implemented for easier customization, better privacy control, and documentation, and content packs were localized for the regional context.
|
||||
- Network & Connectivity: Support for multiple boxes on shared networks with automatic DNS resolution was added, alongside successful integration of encrypted delay-tolerant messaging services (DeltaChat+MadMail).
|
||||
- System Stability: A new Debian foundation improved stability for simultaneous users and an updated database option improved the message board scalability and performance.
|
||||
- Maintenance & Security: New methods for offline updates and administrative management were established, and a comprehensive tamper resistance guide was developed to protect the ecosystem.
|
||||
- Research & Collaboration: Testing confirmed the viability of long-range wireless networks, while local partners provided ongoing feedback and testing support.
|
||||
|
||||
In summary, this rapid four-month sprint supported a major step forward for the capabilities, security, and relevance of the RCBox project for the Eastern European context and threat model. We are on the cusp of shipping all of this new functionality and documentation as part of a major new release, and deeply appreciate the support from this funding that got us to this point.
|
||||
|
||||
[Read the full report](pathname:///files/FINAL_REPORT_RCBox_ExtendEast-April_2026.pdf)
|
||||
|
||||
{/* truncate */}
|
||||
|
|
@ -25,7 +25,7 @@ Always choose the Latest Version of the file.
|
|||
|
||||
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>
|
||||
<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.
|
||||
|
|
|
|||
|
|
@ -48,10 +48,10 @@ When you format a USB drive, all files and folders on the drive are removed and
|
|||
* Select "Start" and click "OK" to finish formatting your flash drive.
|
||||
* A final prompt will appear, Click “OK”. Your flash drive has successfully been formatted.<br/>
|
||||
|
||||
|
||||
.png>).png>).png>)
|
||||
|
||||
|
||||
.png>)
|
||||
|
||||
|
||||
.png>)
|
||||
|
||||
<br/>
|
||||
|
|
|
|||
|
|
@ -38,7 +38,7 @@ Recommendations:
|
|||
|
||||
| 1) Sealed enclosures | 2) Screws |
|
||||
| --------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
|  | .jpeg>) |
|
||||
|
||||
#### 
|
||||
|
||||
|
|
@ -60,9 +60,9 @@ Optional (higher risk contexts):
|
|||
|
||||
| Epoxy Resin | Epoxy Resin |
|
||||
| --------------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
| .jpeg>) | .jpeg>) |
|
||||
|
||||
#### 
|
||||
#### .jpeg>)
|
||||
|
||||
#### Power & Port Management
|
||||
|
||||
|
|
@ -75,7 +75,7 @@ Recommendations:
|
|||
|
||||
| USB & HDMI | Ethernet Ports |
|
||||
| --------------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
| .jpeg>) | .jpeg>) |
|
||||
|
||||
#### Environmental & Operational Practices
|
||||
|
||||
|
|
@ -84,7 +84,7 @@ Recommendations:
|
|||
* Store boxes in controlled locations when not in use
|
||||
* Rotate devices periodically in long deployments
|
||||
* Assume devices may be copied or lost
|
||||
* Treat Butter Boxes as semi-disposable infrastructure, not personal devices.
|
||||
* Treat Butter Boxes as semi-disposable infrastructure, not personal devices.<br/>
|
||||
|
||||
### Section 2: Digital Tamper Resistance
|
||||
|
||||
|
|
@ -102,7 +102,7 @@ RaspAP
|
|||
|
||||
* The access point has an administrative interface that can be used to change its settings.
|
||||
* Defaults: user: admin, password: secret (ironically, this is not secret).
|
||||
* Change this by logging in at [http://butterbox.lan/admin](http://butterbox.lan/admin) (or [http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin) for a Spanish language box) and using the Web UI.
|
||||
* Change this by logging in at[ http://butterbox.lan/admin](http://butterbox.lan/admin) (or[ http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin) for a Spanish language box) and using the Web UI.
|
||||
|
||||
Chat
|
||||
|
||||
|
|
|
|||
|
|
@ -28,7 +28,7 @@ Place individual files directly in the **main directory** (root) of your USB dri
|
|||
|
||||
Insert the USB drive into your Butter Box. After connecting your USB drive to the Raspberry Pi you will see the **Files** tile displayed when you open the Butter Box portal.
|
||||
|
||||
<div><figure><img src="/img/docs/Screenshot_20260414-122810.png" alt=""/><figcaption></figcaption></figure> <figure><img src="/img/docs/Screenshot_20260414-122821.png" alt=""/><figcaption></figcaption></figure></div>
|
||||
<div><figure><img src="/img/docs/Screenshot_20260414-122810 (1).png" alt=""/><figcaption></figcaption></figure> <figure><img src="/img/docs/Screenshot_20260414-122821 (1).png" alt=""/><figcaption></figcaption></figure></div>
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -327,13 +327,13 @@
|
|||
"description": "The title of the tag list page"
|
||||
},
|
||||
"home.title": {
|
||||
"message": "Sharing offline has never been easier"
|
||||
"message": "Introducing Butter Box"
|
||||
},
|
||||
"home.subtitle1": {
|
||||
"message": "Power your own hotspot to share educational materials, videos and apps in small groups or classrooms."
|
||||
"message": "Life without internet made smoother."
|
||||
},
|
||||
"home.subtitle2": {
|
||||
"message": "No internet required."
|
||||
"message": "Get access to tools that help."
|
||||
},
|
||||
"home.whatisbutterbox": {
|
||||
"message": "An app store, encrypted chat, and more, all available over WiFi from an off-the-grid Raspberry Pi."
|
||||
|
|
@ -342,7 +342,7 @@
|
|||
"message": "How does it work?"
|
||||
},
|
||||
"home.section1.description": {
|
||||
"message": "Butter Box broadcasts its own WiFi network. Once you join, you can install Butter, get apps, join a public chatroom, or make your own private one to share with friends. Butter Box works even when there's no Internet. Just stop by the box to download more apps or check in on your chatrooms. Everything is stored right on the Butter Box."
|
||||
"message": "Butter Box is a self-contained microserver and wifi hotspot. Once you join, you can access apps, connect to secure messaging, join a public chatroom, access maps, or any other content and services. ButterBox works even when there's no Internet. Just stop by the box to download more apps or check in on your chatrooms. Everything is stored right there."
|
||||
},
|
||||
"home.learnmore": {
|
||||
"message": "Learn More"
|
||||
|
|
|
|||
|
|
@ -1,16 +1,14 @@
|
|||
---
|
||||
description: 'DIY instructions'
|
||||
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.
|
||||
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.
|
||||
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 |
|
||||
| -------------------------------------------------------------------------------------------------------------------------------- | ----------------------------------------------------------------- | ------------------------------------------------- |
|
||||
|
|
@ -18,6 +16,5 @@ Butter Box software currently runs on Raspberry Pi devices: Pi Zero 2 and Pi
|
|||
| <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.
|
||||
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.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,35 +1,24 @@
|
|||
---
|
||||
description: 'How to turn an old PC into golden deliciuos butter!'
|
||||
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.
|
||||
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!
|
||||
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_".
|
||||
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/).
|
||||
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)
|
||||
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
|
||||
|
|
@ -37,12 +26,9 @@ This image can be flashed to a bootable USB drives, using
|
|||
|
||||
## How to Boot Up
|
||||
|
||||
Once the USB drive is flashed, you can now use it to boot up ButterBox on
|
||||
your old PC.
|
||||
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.
|
||||
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.
|
||||
|
|
@ -50,20 +36,15 @@ your old PC.
|
|||
|
||||
## How to Access
|
||||
|
||||
Once the ButterBox PC is booted up, and plugged into a local router, it
|
||||
should be ready 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)
|
||||
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 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!)
|
||||
- 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!)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,25 +1,16 @@
|
|||
---
|
||||
description: 'Different ways to power your Butter Box'
|
||||
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.
|
||||
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/)
|
||||
* **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>
|
||||
|
|
|
|||
|
|
@ -3,32 +3,18 @@ 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.
|
||||
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.
|
||||
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.
|
||||
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: [\
|
||||
* [ ] 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.
|
||||
* [ ] 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)
|
||||
|
||||
|
|
|
|||
|
|
@ -1,29 +1,20 @@
|
|||
---
|
||||
description: 'How To Add a Router To Your Box Setup'
|
||||
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.
|
||||
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.
|
||||
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.
|
||||
* [ ] 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)
|
||||
|
||||
|
|
@ -35,10 +26,7 @@ _No internet connection is required._
|
|||
|
||||
## 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.
|
||||
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.
|
||||
|
||||
|
|
@ -46,24 +34,16 @@ 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.
|
||||
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.
|
||||
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.
|
||||
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.
|
||||
Users will now join the Wi-Fi network of the router when they want to connect to the Butter Box.
|
||||
|
|
|
|||
|
|
@ -1,5 +1,5 @@
|
|||
---
|
||||
description: 'Install Butter Operating System (OS) on an SD card for Raspberry Pi'
|
||||
description: Install Butter Operating System (OS) on an SD card for Raspberry Pi
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
|
|
@ -13,8 +13,7 @@ You will need:
|
|||
|
||||
### 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.
|
||||
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)
|
||||
|
||||
|
|
@ -24,10 +23,9 @@ 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:
|
||||
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>
|
||||
<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.
|
||||
|
|
@ -35,25 +33,19 @@ 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.
|
||||
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/)
|
||||
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.
|
||||
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.
|
||||
* 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>
|
||||
|
||||
|
|
@ -67,22 +59,17 @@ 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”_.
|
||||
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.
|
||||
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.
|
||||
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.**
|
||||
|
||||
|
|
@ -92,11 +79,9 @@ section for more details.
|
|||
|
||||
### Troubleshooting
|
||||
|
||||
If you see an error stating that the input file is not a valid disk image,
|
||||
check the file you downloaded.
|
||||
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.
|
||||
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.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,24 +1,15 @@
|
|||
---
|
||||
description: 'Different ways to power your Butter Box'
|
||||
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.
|
||||
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/)
|
||||
* **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>
|
||||
|
|
|
|||
|
|
@ -1,160 +0,0 @@
|
|||
---
|
||||
description: 'How to Create Your Own F-Droid Repo to Share as a Content Pack'
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# F-Droid Repo
|
||||
|
||||
You can build your own curated F-Droid repo using your computer's
|
||||
terminal. Once set up, users can connect their F-Droid app to your Butter
|
||||
Box and start downloading apps.
|
||||
|
||||
|
||||
|
||||
### Step 1: Install F-Droid Server Tools
|
||||
|
||||
Before you begin, you need to install a tool called **fdroidserver**. This
|
||||
helps you create and manage your app store.
|
||||
|
||||
**On Mac (using Homebrew):**
|
||||
|
||||
```
|
||||
brew install fdroidserver
|
||||
```
|
||||
|
||||
**On Linux (Debian/Ubuntu):**
|
||||
|
||||
```
|
||||
sudo apt install fdroidserver
|
||||
```
|
||||
|
||||
### Step 2: Check that it's installed correctly
|
||||
|
||||
After installation, run this command:
|
||||
|
||||
```
|
||||
fdroid version
|
||||
```
|
||||
|
||||
If everything is working, you will see a version number printed on the
|
||||
screen.
|
||||
|
||||
### Step 3: Create Your Repo Folder
|
||||
|
||||
You need to create the folder where you will save the repo files in your
|
||||
computer, choose a name that aligns with the project or purpose of the apps
|
||||
in it, and replace my-fdroid-repo for that name in the command.
|
||||
|
||||
```
|
||||
mkdir -p ~/my-fdroid-repo
|
||||
```
|
||||
|
||||
```
|
||||
cd ~/my-fdroid-repo
|
||||
```
|
||||
|
||||
### Step 4: Initialize the repo
|
||||
|
||||
```
|
||||
fdroid init
|
||||
```
|
||||
|
||||
This creates the following directories in your repo file:
|
||||
|
||||
```
|
||||
Config.yml
|
||||
```
|
||||
|
||||
```
|
||||
repo/
|
||||
```
|
||||
|
||||
```
|
||||
metadata/
|
||||
```
|
||||
|
||||
### Step 5: Add your APKs
|
||||
|
||||
Copy your signed APKs into the repo/ folder. Ensure you only use apps from
|
||||
trusted sources like the official F-Droid library or verified developers.
|
||||
|
||||
**Security Note:** Avoid downloading APKs from "mirror" sites or unknown sources, as they can contain malware or trackers that compromise your users' privacy.
|
||||
|
||||
```
|
||||
cp /path/to/your/*.apk repo/
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```
|
||||
cp ~/Downloads/myapp.apk repo/
|
||||
```
|
||||
|
||||
### Step 6: Generate (and Update) the Repository Index
|
||||
|
||||
Every time you add a new APK or a new version of an app to your repo/
|
||||
folder, you must run the following command to "publish" those changes:
|
||||
|
||||
```
|
||||
fdroid update --create-metadata
|
||||
```
|
||||
|
||||
What this command does:
|
||||
|
||||
* **Scans APKs:** It reads the new files in your repo/ folder.
|
||||
* **Generates Metadata:** It creates YAML files containing the app's name,
|
||||
version, and permissions.
|
||||
* **Creates index.v1.jar:** This is the "catalog" file that the F-Droid app
|
||||
downloads to see what is available.
|
||||
* **Signs the Repository:** It uses your secret key to sign the index,
|
||||
proving to the Android app that the files haven't been tampered with.
|
||||
|
||||
### Step 7: Test your Repo locally
|
||||
|
||||
To test your repo locally and ensure everything works before you share it on
|
||||
the Butter Box, you can serve its content locally and add it to F-Droid
|
||||
using a URL.
|
||||
|
||||
```
|
||||
cd repo
|
||||
```
|
||||
|
||||
```
|
||||
python3 -m http.server 8000
|
||||
```
|
||||
|
||||
Once your repo is live, open the F-Droid app on your device and navigate to **Settings > Repositories > "+"**. Select **"Enter repository URL manually"** to add your new source.
|
||||
|
||||
Adding the repo manually allows you to verify the user experience by
|
||||
checking:
|
||||
|
||||
* **App Visibility:** Are all your apps appearing in the list?
|
||||
* **Visual Assets:** Are icons and screenshots displaying correctly?
|
||||
* **Categorization:** Are apps appearing in the correct sections (e.g.,
|
||||
Internet, Security)?
|
||||
* **Functionality:** Do the downloads and installations complete without
|
||||
errors?
|
||||
* **Metadata:** Does the version number and description match your `repo/`
|
||||
files?
|
||||
|
||||
|
||||
|
||||
Your repo will be available at:
|
||||
|
||||
`http://YOUR-IP:8000/repo`
|
||||
|
||||
|
||||
|
||||
**Find your IP:**
|
||||
|
||||
#### macOS:
|
||||
|
||||
```
|
||||
ipconfig getifaddr en0
|
||||
```
|
||||
|
||||
#### Linux:
|
||||
|
||||
```
|
||||
hostname -I
|
||||
```
|
||||
|
|
@ -1,50 +0,0 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Apps
|
||||
|
||||
You can share apps as a content pack, via a static website. If you give a
|
||||
folder the name `appstore` and place it in the root directory of the USB
|
||||
drive, the **Apps** tile will appear in the Butter Box portal.
|
||||
|
||||
**Things To Know**
|
||||
|
||||
* If you are sharing apps from Butter Box, you will need to download the app
|
||||
files you want to share. Apps are updated frequently. Be sure to manually
|
||||
update all of the app files frequently to ensure you are providing the
|
||||
highest security for the people who connect to the box.
|
||||
* You’ll need a copy of the app’s `.apk` file — make sure it’s from a safe
|
||||
and trusted source.
|
||||
* Butter won’t automatically verify the source, so it's up to you to
|
||||
confirm it's clean and legal to share.
|
||||
* How to get apk files: There are mobile apps you can use to get access to
|
||||
apk files on an Android phone. Alternatively, you can download app files
|
||||
directly from the developer's website.
|
||||
|
||||
### Go Further: Butter Box Supports Sharing Via F-Droid
|
||||
|
||||
Additionally, Butter Box supports app distribution via F-Droid. In your
|
||||
content pack, you can include the F-Droid `.apk` and a QR code for your
|
||||
repo. Anyone with access to the Box can then download the F-Droid app while
|
||||
offline, and add the repo.
|
||||
|
||||
As long as they are connected to the Butter Box, they can download any of
|
||||
the apps within your repo.
|
||||
|
||||
If they are connected to the internet later, they can receive app updates
|
||||
from any apps in your repo that are also included in the official F-Droid
|
||||
repo. If you update the apps in your repo, they will also have access to
|
||||
those.
|
||||
|
||||
What is a F-Ddroid Repo?
|
||||
|
||||
* A hosted library of apps\ Why use it?
|
||||
* It offers a secure process for sharing apps. The F-Droid team builds apps
|
||||
in the official F-Droid repo from the source code themselves. This ensures
|
||||
that the app you download exactly matches the code the developer
|
||||
published.
|
||||
* Users installing from F-Droid have access to app updates remotely (away
|
||||
from the Butter Box)
|
||||
|
||||
Technical skills are required to create your own F-Droid repo. Refer to the
|
||||
[F-Droid Repo](f-droid-repo) Section for instructions.
|
||||
|
|
@ -1,72 +1,44 @@
|
|||
---
|
||||
description: 'Curated pluggable content'
|
||||
description: Curated pluggable content
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Content Packs
|
||||
|
||||
You can create your own content pack! It simply needs to be set up as a
|
||||
**static website with local links**. This website will run from the box
|
||||
itself, so all of the images and files required for the website need to be
|
||||
contained within one main folder.
|
||||
You can create your own content pack! It simply needs to be set up as a **static website with local links**. This website will run from the box itself, so all of the images and files required for the website need to be contained within one main folder.
|
||||
|
||||
Once you have your static website ready, you will put all of the required
|
||||
files for it in one folder, and place this folder in the **root directory**
|
||||
of your USB drive. This website will be rendered in the browser people use
|
||||
to access the Butter Box portal.
|
||||
Once you have your static website ready, you will put all of the required files for it in one folder, and place this folder in the **root directory** of your USB drive. This website will be rendered in the browser people use to access the Butter Box portal.
|
||||
|
||||
Tips for creating a content pack with a static website:
|
||||
|
||||
* **Contents.** Everything for the static website must be stored on a USB
|
||||
drive that plugs into the Butter Box. It should not link to resources on
|
||||
the global internet.
|
||||
* **Size.** The size of your content pack is limited by the amount of space
|
||||
available on your USB drive. Though, keep in mind that if multiple people
|
||||
are downloading or watching really large files from the box, there may be
|
||||
some latency.
|
||||
* **Pages.** Links between pages should point to other saved pages in the
|
||||
same folder, not to the internet. You must use relative paths
|
||||
(e.g. about/index.html) instead of absolute web URLs.
|
||||
* **Media.** Pictures, videos, and sounds cannot be linked to from somewhere
|
||||
online. The files need to be in your website folder and stored on the USB
|
||||
drive.
|
||||
* **Libraries.** The website cannot use javascript libraries that rely on an
|
||||
internet connection.
|
||||
* **Styles.** Special fonts and icons (like those from Google Fonts) also
|
||||
need to be packed into the folder, not fetched from the web.
|
||||
* **Contents.** Everything for the static website must be stored on a USB drive that plugs into the Butter Box. It should not link to resources on the global internet.
|
||||
* **Size.** The size of your content pack is limited by the amount of space available on your USB drive. Though, keep in mind that if multiple people are downloading or watching really large files from the box, there may be some latency.
|
||||
* **Pages.** Links between pages should point to other saved pages in the same folder, not to the internet. You must use relative paths (e.g. about/index.html) instead of absolute web URLs.
|
||||
* **Media.** Pictures, videos, and sounds cannot be linked to from somewhere online. The files need to be in your website folder and stored on the USB drive.
|
||||
* **Libraries.** The website cannot use javascript libraries that rely on an internet connection.
|
||||
* **Styles.** Special fonts and icons (like those from Google Fonts) also need to be packed into the folder, not fetched from the web.
|
||||
|
||||
### Try It
|
||||
|
||||
* The zip file below contains a sample static website. To get a feel for how
|
||||
static websites work with butter—Download it. Unzip it. Then, add this set
|
||||
of files to your USB drive.
|
||||
* The zip file below contains a sample static website. To get a feel for how static websites work with butter—Download it. Unzip it. Then, add this set of files to your USB drive.
|
||||
|
||||
[Sample Static Website.zip](/img/docs/Sample%20Static%20Website.zip)
|
||||
|
||||
You can also check out our [New Content Pack News](/docs/content-packs).
|
||||
[Sample Static Website.zip](/img/docs/Sample Static Website.zip)
|
||||
|
||||
### Get Started
|
||||
|
||||
The best way to get started with creating your own content pack is to have
|
||||
an idea about the experience and type of information you want to provide,
|
||||
and then to design and build a local static website for it.
|
||||
The best way to get started with creating your own content pack is to have an idea about the experience and type of information you want to provide, and then to design and build a local static website for it.
|
||||
|
||||
It can be very simple like an audio player for music. Or, a simple list of
|
||||
the five top VPN apps that you recommend. Or it can be more complex like a
|
||||
library or knowledge base of cultural artifacts.
|
||||
It can be very simple like an audio player for music. Or, a simple list of the five top VPN apps that you recommend. Or it can be more complex like a library or knowledge base of cultural artifacts.
|
||||
|
||||
|
||||
|
||||
### Add website files to a USB drive
|
||||
|
||||
Place a folder with your website files in the **root directory** of a USB
|
||||
drive. Be sure that your website folder contains your **index.html.** The
|
||||
name of this folder will be displayed on the Butter Box portal.
|
||||
Place a folder with your website files in the **root directory** of a USB drive. Be sure that your website folder contains your **index.html.** The name of this folder will be displayed on the Butter Box portal.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.46.16 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
|
||||
### Connect to your Butter Box to view
|
||||
|
||||
Insert the USB drive into your Butter Box. When you open the Butter Box
|
||||
portal, tap **Files**. Navigate to the website folder. Tap to view.
|
||||
Insert the USB drive into your Butter Box. When you open the Butter Box portal, tap **Files**. Navigate to the website folder. Tap to view.
|
||||
|
||||
|
|
|
|||
|
|
@ -3,8 +3,7 @@ sidebar_position: 2
|
|||
---
|
||||
# Maps
|
||||
|
||||
You can make offline maps available from your Butter Box. These maps are
|
||||
powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android.
|
||||
You can make offline maps available from your Butter Box. These maps are powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android.
|
||||
|
||||
:::warning
|
||||
**Important:** Offline map downloads work **only on Android devices**. iOS is not supported.
|
||||
|
|
@ -14,13 +13,12 @@ powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android.
|
|||
|
||||
**1. Download the map files you need**
|
||||
|
||||
* Visit: [OsmAnd Local Indexes
|
||||
List](https://osmand.net/list?sortby=size\&asc=false)
|
||||
* Visit: [OsmAnd Local Indexes List](https://osmand.net/list?sortby=size\&asc=false)
|
||||
* Choose and download the regions you want available offline.
|
||||
|
||||
**2. Organize your files**
|
||||
|
||||
* On your USB drive, create a folder named `osm-map-files` .
|
||||
* On your USB drive, create a folder named `osm-map-files` .
|
||||
* Put the **OsmAnd APK** and all your **map files** into this folder.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.44.40 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
|
|
@ -28,14 +26,8 @@ powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android.
|
|||
**3. Add to your Butter Box**
|
||||
|
||||
* Insert the USB drive into your Butter Box.
|
||||
* The **Offline Maps** tile will automatically appear in your Butter Box
|
||||
portal.
|
||||
* The **Offline Maps** tile will automatically appear in your Butter Box portal.
|
||||
|
||||
👉 That’s it — anyone using an **Android device** can now download OsmAnd and
|
||||
the offline maps you’ve provided directly from your Butter Box.
|
||||
👉 That’s it — anyone using an **Android device** can now download OsmAnd and the offline maps you’ve provided directly from your Butter Box.
|
||||
|
||||
Note: The OSM map apk is available on the Butter Box software image. Updates
|
||||
to the OsmAnd app will be available with new releases of the Butter Box
|
||||
software. If you want to know what the latest available version of OsmAnd
|
||||
app is, visit [OsmAnd Free Releases —
|
||||
Android](https://osmand.net/docs/versions/free-versions).
|
||||
Note: The OSM map apk is available on the Butter Box software image. Updates to the OsmAnd app will be available with new releases of the Butter Box software. If you want to know what the latest available version of OsmAnd app is, visit [OsmAnd Free Releases — Android](https://osmand.net/docs/versions/free-versions).
|
||||
|
|
|
|||
|
|
@ -3,10 +3,7 @@ sidebar_position: 2
|
|||
---
|
||||
# How to Reformat Your USB Drive
|
||||
|
||||
After connecting your USB drive to the Raspberry Pi you will see the
|
||||
“Explore USB” title displayed on the portal. If you’ve tried refreshing your
|
||||
portal page and still do not see the “Explore USB” tile then you may need to
|
||||
erase your USB stick and reformat it.
|
||||
After connecting your USB drive to the Raspberry Pi you will see the “Explore USB” title displayed on the portal. If you’ve tried refreshing your portal page and still do not see the “Explore USB” tile then you may need to erase your USB stick and reformat it.
|
||||
|
||||
<br/>
|
||||
|
||||
|
|
@ -16,7 +13,7 @@ When you format a USB drive, all files and folders on the drive are removed and
|
|||
|
||||
**Check the Format of the USB**
|
||||
|
||||
* On your desktop or laptop, plug in your USB
|
||||
* On your desktop or laptop, plug in your USB
|
||||
* Right, or double-click on the USB
|
||||
* Click on “Get info” and verify the Format
|
||||
* Your USB needs to be formatted to ExFat or Fat32, MS-DOS (FAT).
|
||||
|
|
@ -27,14 +24,12 @@ When you format a USB drive, all files and folders on the drive are removed and
|
|||
|
||||
* Connect the USB drive to a USB port on your computer.
|
||||
* Right, or double-click on the USB
|
||||
* Click on “Erase Disk…”
|
||||
* Click on “Erase Disk…”
|
||||
* You can rename your USB at this time
|
||||
* Select the correct format, either ExFat or ExFat32 or MS-DOS (FAT)
|
||||
* Then tap “Erase”
|
||||
* A message may appear warning you that all content will be deleted. Select
|
||||
“Erase”
|
||||
* This may take a few minutes. The USB will disappear and reappear on your
|
||||
homescreen
|
||||
* A message may appear warning you that all content will be deleted. Select “Erase”
|
||||
* This may take a few minutes. The USB will disappear and reappear on your homescreen
|
||||
* Verify the drive is correctly formatted
|
||||
* Right, or double-click on the USB
|
||||
* Click on “Get info” and verify the Format<br/>
|
||||
|
|
@ -43,26 +38,20 @@ When you format a USB drive, all files and folders on the drive are removed and
|
|||
|
||||
* Connect the USB drive to a USB port on your computer.
|
||||
* Open the File Explorer and select "This PC" from the menu.
|
||||
* You can find this option in the left panel, next to a monitor
|
||||
icon.[\[2\]](https://www.wikihow.com/Format-a-Flash-Drive#_note-2)
|
||||
* You can find this option in the left panel, next to a monitor icon.[\[2\]](https://www.wikihow.com/Format-a-Flash-Drive#_note-2)
|
||||
* On Windows 7, click Computer on the right side of the Start window.
|
||||
* Right-click the flash drive's icon. It's beneath the "Devices and drives"
|
||||
heading in the middle of the page. This will bring up a drop-down menu.
|
||||
* Right-click the flash drive's icon. It's beneath the "Devices and drives" heading in the middle of the page. This will bring up a drop-down menu.
|
||||
* Choose "Format". This will open the formatting window.
|
||||
* Click on "File System" and choose the MS-DOS, FAT32, or exFAT format.
|
||||
* [FAT32](https://www.wikihow.com/Format-FAT32) - The most widely compatible
|
||||
format. Works with most computers and gaming consoles.
|
||||
* exFAT - Similar to FAT32, but designed for external hard drives (e.g.,
|
||||
flash drives) and quicker use. It's a universal format that is most common
|
||||
across Windows, Linux, and Mac.
|
||||
* [FAT32](https://www.wikihow.com/Format-FAT32) - The most widely compatible format. Works with most computers and gaming consoles.
|
||||
* exFAT - Similar to FAT32, but designed for external hard drives (e.g., flash drives) and quicker use. It's a universal format that is most common across Windows, Linux, and Mac.
|
||||
* Select "Start" and click "OK" to finish formatting your flash drive.
|
||||
* A final prompt will appear, Click “OK”. Your flash drive has successfully
|
||||
been formatted.<br/>
|
||||
* A final prompt will appear, Click “OK”. Your flash drive has successfully been formatted.<br/>
|
||||
|
||||
|
||||
.png>).png>).png>)
|
||||
|
||||
|
||||
.png>)
|
||||
|
||||
|
||||
.png>)
|
||||
|
||||
<br/>
|
||||
|
|
|
|||
|
|
@ -5,54 +5,35 @@ sidebar_position: 1
|
|||
|
||||
### Does the Butter Box give me the internet?
|
||||
|
||||
Not quite. The Butter Box doesn’t provide internet access. Instead, it
|
||||
creates its own local Wi-Fi network that lets you access apps, content
|
||||
(previously set up), and message board features offline . Everything is
|
||||
stored and shared locally — no internet or data connection needed.
|
||||
Not quite. The Butter Box doesn’t provide internet access. Instead, it creates its own local Wi-Fi network that lets you access apps, content (previously set up), and message board features offline . Everything is stored and shared locally — no internet or data connection needed.
|
||||
|
||||
***
|
||||
|
||||
### How do you power a Butter Box?
|
||||
|
||||
The Butter Box is super flexible! You can power it using a USB power bank, a
|
||||
wall adapter, or even a small solar panel. As long as it provides power to
|
||||
the Raspberry Pi, you’re good to go. Go to the [Power
|
||||
Supply](../build-a-box/power-supply) section to learn more.
|
||||
The Butter Box is super flexible! You can power it using a USB power bank, a wall adapter, or even a small solar panel. As long as it provides power to the Raspberry Pi, you’re good to go. Go to the [Power Supply](../build-a-box/power-supply) section to learn more.
|
||||
|
||||
***
|
||||
|
||||
### If I’m powering the Butter Box with a solar panel, do I need a power bank?
|
||||
|
||||
A power bank isn’t strictly required, but it’s highly recommended. Solar
|
||||
panels can be inconsistent — clouds, shade, or changing sunlight can
|
||||
interrupt power. A power bank helps smooth that out by storing energy and
|
||||
keeping the Butter Box running steadily, even when sunlight dips. Check it
|
||||
out this use case to know more: (insert use case URL)
|
||||
A power bank isn’t strictly required, but it’s highly recommended. Solar panels can be inconsistent — clouds, shade, or changing sunlight can interrupt power. A power bank helps smooth that out by storing energy and keeping the Butter Box running steadily, even when sunlight dips. Check it out this use case to know more: (insert use case URL)
|
||||
|
||||
***
|
||||
|
||||
### What are the security features of the Butter Box? Can I put a password on it?
|
||||
|
||||
Currently, the Butter Box broadcasts an open Wi-Fi network — that means no
|
||||
password is required to connect. This makes it easy for people nearby to
|
||||
join, especially in offline or community settings.
|
||||
Currently, the Butter Box broadcasts an open Wi-Fi network — that means no password is required to connect. This makes it easy for people nearby to join, especially in offline or community settings.
|
||||
|
||||
However, users must either enter the Butter Box’s local IP address manually,
|
||||
or scan a QR code that takes them directly to the content. Since it’s all
|
||||
offline, there’s no exposure to the internet or external threats.
|
||||
However, users must either enter the Butter Box’s local IP address manually, or scan a QR code that takes them directly to the content. Since it’s all offline, there’s no exposure to the internet or external threats.
|
||||
|
||||
You can configure the Raspberry Pi to require a Wi-Fi password in the admin
|
||||
settings. Refer to the [Security](../security) section for more security
|
||||
features.
|
||||
You can configure the Raspberry Pi to require a Wi-Fi password in the admin settings. Refer to the [Security](../security) section for more security features.
|
||||
|
||||
***
|
||||
|
||||
### How much storage does a Butter Box have?
|
||||
|
||||
The Butter Box storage capacity is defined by the microSD card you install —
|
||||
it doesn’t have fixed built-in memory. You can choose anything from a 16 GB
|
||||
card up to 1 TB (the Raspberry Pi Zero 2 W supports microSD sizes up to
|
||||
that). We recommend 256 GB.
|
||||
The Butter Box storage capacity is defined by the microSD card you install — it doesn’t have fixed built-in memory. You can choose anything from a 16 GB card up to 1 TB (the Raspberry Pi Zero 2 W supports microSD sizes up to that). We recommend 256 GB.
|
||||
|
||||
| Use Case | Suggested micro SD Size |
|
||||
| ------------------------------------- | -------------------------- |
|
||||
|
|
@ -64,14 +45,10 @@ that). We recommend 256 GB.
|
|||
|
||||
### Can I customize it?
|
||||
|
||||
Absolutely! You can add, for example, your own content - dropping in PDFs,
|
||||
videos, images, and HTML pages to build a local library, or add your own
|
||||
apps - including Android APKs (even if they’re not on F-Droid).
|
||||
Absolutely! You can add, for example, your own content - dropping in PDFs, videos, images, and HTML pages to build a local library, or add your own apps - including Android APKs (even if they’re not on F-Droid).
|
||||
|
||||
***
|
||||
|
||||
### My USB drive is plugged into the Butter Box, but the content is not displayed on the portal. Why?
|
||||
|
||||
Yout USB drive is probably in the wrong format. Your USB needs to be
|
||||
formatted to ExFat, Fat32, MS-DOS (FAT). Refer to [Reformatting Your
|
||||
USB](how-to-reformat-your-usb-drive) for help.
|
||||
Yout USB drive is probably in the wrong format. Your USB needs to be formatted to ExFat, Fat32, MS-DOS (FAT). Refer to [Reformatting Your USB](how-to-reformat-your-usb-drive) for help.
|
||||
|
|
|
|||
|
|
@ -1,17 +1,15 @@
|
|||
---
|
||||
description: 'Sharing offline has never been easier!'
|
||||
description: Sharing offline has never been easier!
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Get Started
|
||||
# Comenzar
|
||||
|
||||
Butter Box is a lightweight, portable device that functions like a hard
|
||||
drive with its own hotspot. Anyone nearby can connect to it and view or
|
||||
download its contents—no internet required.
|
||||
Butter Box es un dispositivo ligero y portátil que funciona como un disco duro con su propio punto de acceso (hotspot). Cualquier persona cercana puede conectarse a él y ver o descargar su contenido, sin necesidad de internet.
|
||||
|
||||
Whether you have a Butter Box in your hands or you need to build one, you're
|
||||
in the right spot. Choose an option below.
|
||||
Ya sea que tengas un Butter Box en tus manos o necesites construir uno, estás en el lugar indicado. Elige una opción a continuación.
|
||||
|
||||
<table data-view="cards"><thead><tr><th></th><th data-type="content-ref"></th></tr></thead><tbody><tr><td>I Have A Box</td><td><a href="quick-start">quick-start.md</a></td></tr><tr><td>I Need A Box</td><td><a href="build-a-box/">build-a-box</a></td></tr></tbody></table>
|
||||
|
||||
## [I Have A Box](quick-start.mdx) ...or... [I Need A Box](build-a-box/)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -3,8 +3,7 @@ sidebar_position: 2
|
|||
---
|
||||
# Quick Start
|
||||
|
||||
If you have a Butter Box with the latest version of the Butter software
|
||||
loaded on the SD card, take these quick steps to get set up.
|
||||
If you have a Butter Box with the latest version of the Butter software loaded on the SD card, take these quick steps to get set up.
|
||||
|
||||
### Check supplies
|
||||
|
||||
|
|
@ -24,20 +23,15 @@ The micro SD card should have the latest version of Butter OS running on it.
|
|||
|
||||
### Plug it in to power on
|
||||
|
||||
Connect the power supply to the first micro USB port and correct wall
|
||||
outlet.
|
||||
Connect the power supply to the first micro USB port and correct wall outlet.
|
||||
|
||||
<figure><img src="/img/docs/1.png" alt="" width="375"/><figcaption></figcaption></figure>
|
||||
|
||||
You will know the box is working if ‘butterbox’ wifi appears in the wifi
|
||||
list on your phone or computer. If it doesn’t, unplug the box and plug it
|
||||
back in.
|
||||
You will know the box is working if ‘butterbox’ wifi appears in the wifi list on your phone or computer. If it doesn’t, unplug the box and plug it back in.
|
||||
|
||||
|
||||
|
||||
_If using a solar battery or other means of power, use one with the correct
|
||||
specs to ensure adequate power and avoid damage to the unit. For a Pi Zero 2
|
||||
W use Micro USB power supply with at least 2.0A._
|
||||
_If using a solar battery or other means of power, use one with the correct specs to ensure adequate power and avoid damage to the unit. For a Pi Zero 2 W use Micro USB power supply with at least 2.0A._
|
||||
|
||||
[Link to Power Supply Options](build-a-box/power-supply)
|
||||
|
||||
|
|
@ -45,42 +39,33 @@ W use Micro USB power supply with at least 2.0A._
|
|||
|
||||
### Insert USB drive
|
||||
|
||||
Connect the USB adapter to the open port. Then plug in the USB drive. Learn
|
||||
more about loading the USB drive with treasures in the [File
|
||||
Sharing](services/file-sharing) section.
|
||||
Connect the USB adapter to the open port. Then plug in the USB drive. Learn more about loading the USB drive with treasures in the [File Sharing](services/file-sharing) section.
|
||||
|
||||
<figure><img src="/img/docs/2.png" alt="" width="375"/><figcaption></figcaption></figure>
|
||||
|
||||
### Access the Butter Box Portal
|
||||
|
||||
Join the ‘butterbox’ Wi-Fi. After 30 seconds, scan the QR code on the
|
||||
box. This connects you to **http://butterbox.local** in a browser.
|
||||
Join the ‘butterbox’ Wi-Fi. After 30 seconds, scan the QR code on the box. This connects you to **http://butterbox.local** in a browser.
|
||||
|
||||
[https://youtu.be/KB5O9MSoaAg](https://youtu.be/KB5O9MSoaAg)
|
||||
|
||||
<div align="center"><figure><img src="/img/docs/qr code.png" alt="" width="375"/><figcaption></figcaption></figure></div>
|
||||
|
||||
_If this page does not load, wait a few minutes to ensure
|
||||
connectivity. Refresh the page. If you’re connecting from a smartphone, turn
|
||||
off your mobile data or turn on airplane mode. Then try again._
|
||||
_If this page does not load, wait a few minutes to ensure connectivity. Refresh the page. If you’re connecting from a smartphone, turn off your mobile data or turn on airplane mode. Then try again._
|
||||
|
||||
:::info
|
||||
This is an HTTP page, not HTTPS, because it's served from a local device with no internet connection. Your data never leaves the network, so it's still private and secure.
|
||||
:::
|
||||
|
||||
The Wi-Fi does not have a password by default. Though, you can easily add
|
||||
one in the Admin Settings.
|
||||
The Wi-Fi does not have a password by default. Though, you can easily add one in the Admin Settings.
|
||||
|
||||
### Once connected, use Admin Settings to set up your box.
|
||||
|
||||
The admin setup wizard is designed to give you choice over which services
|
||||
are offered on the box and to increase its security. You will be prompted to
|
||||
go to Admin Settings if this is the first time you've used the box.
|
||||
The admin setup wizard is designed to give you choice over which services are offered on the box and to increase its security. You will be prompted to go to Admin Settings if this is the first time you've used the box.
|
||||
|
||||
### Share access to the portal
|
||||
|
||||
Once you share with others, they will connect to it in the same way you just
|
||||
did.
|
||||
Once you share with others, they will connect to it in the same way you just did.
|
||||
|
||||
:::info
|
||||
For a Pi Zero 2 W: Up to 5 people can connect to the box at any time. After people connect and get what they need, encourage them to leave the box to give others a turn.\
|
||||
|
|
|
|||
|
|
@ -1,24 +1,17 @@
|
|||
---
|
||||
description: 'How to Make a Butter Box Tamper Resistant'
|
||||
description: How to Make a Butter Box Tamper Resistant
|
||||
sidebar_position: 7
|
||||
---
|
||||
|
||||
# Security
|
||||
|
||||
This guide was designed for deployments in hostile, semi-hostile, or
|
||||
low-trust environments, where devices may be inspected, confiscated,
|
||||
modified, or misused. It aims to provide practical recommendations to make
|
||||
the Butter Box more physically and digitally tamper-resistant.
|
||||
This guide was designed for deployments in hostile, semi-hostile, or low-trust environments, where devices may be inspected, confiscated, modified, or misused. It aims to provide practical recommendations to make the Butter Box more physically and digitally tamper-resistant.
|
||||
|
||||
Following the recommendations in this guide will help reduce risk, not
|
||||
guarantee absolute security. Butter Box is assumed to be a field-deployable,
|
||||
low-cost, offline system, so these recommendations prioritize realistic,
|
||||
maintainable protections.
|
||||
Following the recommendations in this guide will help reduce risk, not guarantee absolute security. Butter Box is assumed to be a field-deployable, low-cost, offline system, so these recommendations prioritize realistic, maintainable protections.
|
||||
|
||||
**Threat Model Assumptions**
|
||||
|
||||
Before applying controls, clearly define your deployment context. This guide
|
||||
assumes one or more of the following risks:
|
||||
Before applying controls, clearly define your deployment context. This guide assumes one or more of the following risks:
|
||||
|
||||
* Physical access by unauthorized users
|
||||
* Device confiscation or inspection by authorities
|
||||
|
|
@ -27,8 +20,7 @@ assumes one or more of the following risks:
|
|||
* Network misuse or impersonation
|
||||
* Credential reuse or default configuration abuse
|
||||
|
||||
Remember that controls should adapt to the local risk level, over-hardening
|
||||
can reduce usability and trust.
|
||||
Remember that controls should adapt to the local risk level, over-hardening can reduce usability and trust.
|
||||
|
||||
|
||||
|
||||
|
|
@ -36,10 +28,7 @@ can reduce usability and trust.
|
|||
|
||||
#### Enclosure and Hardware Protection
|
||||
|
||||
Physical access to the Butter Box allows SD card cloning, firmware
|
||||
replacement, malware injection and broadcasting of malicious
|
||||
information. PCB are also delicate and should have additional protection to
|
||||
keep them safe from everyday handling and weather exposure.
|
||||
Physical access to the Butter Box allows SD card cloning, firmware replacement, malware injection and broadcasting of malicious information. PCB are also delicate and should have additional protection to keep them safe from everyday handling and weather exposure.
|
||||
|
||||
Recommendations:
|
||||
|
||||
|
|
@ -49,7 +38,7 @@ Recommendations:
|
|||
|
||||
| 1) Sealed enclosures | 2) Screws |
|
||||
| --------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
|  | .jpeg>) |
|
||||
|
||||
#### 
|
||||
|
||||
|
|
@ -64,40 +53,29 @@ Recommendations:
|
|||
|
||||
Optional (higher risk contexts):
|
||||
|
||||
1. Epoxy Resin. Electronico potting solutions protect Printed Circuit
|
||||
Boards from extreme temperatures, moisture, vibration, and other
|
||||
environmental threats.
|
||||
1. Epoxy Resin. Electronico potting solutions protect Printed Circuit Boards from extreme temperatures, moisture, vibration, and other environmental threats.
|
||||
2. Physically block SD card removal
|
||||
|
||||
|
||||
|
||||
| Epoxy Resin | Epoxy Resin |
|
||||
| --------------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
| .jpeg>) | .jpeg>) |
|
||||
|
||||
#### 
|
||||
#### .jpeg>)
|
||||
|
||||
#### Power & Port Management
|
||||
|
||||
Recommendations:
|
||||
|
||||
1. Disable or physically block unused ports (USB, HDMI). Inexpensive
|
||||
physical port blockers can be used to reduce the risk of tampering with
|
||||
the Butter Box by preventing unauthorized access to exposed
|
||||
interfaces. These blockers limit the ability of bad actors to inject
|
||||
malicious code, connect unauthorized peripherals, or broadcast unwanted
|
||||
content. Ports are sealed with plastic blockers that can only be removed
|
||||
using a dedicated key included in the deployment kit.
|
||||
2. Avoid exposing Ethernet ports unless required. Ethernet ports should
|
||||
remain disabled or physically blocked unless they are explicitly required
|
||||
for the deployment. When Ethernet access is necessary, its use should be
|
||||
clearly documented and limited to trusted operators.
|
||||
1. Disable or physically block unused ports (USB, HDMI). Inexpensive physical port blockers can be used to reduce the risk of tampering with the Butter Box by preventing unauthorized access to exposed interfaces. These blockers limit the ability of bad actors to inject malicious code, connect unauthorized peripherals, or broadcast unwanted content. Ports are sealed with plastic blockers that can only be removed using a dedicated key included in the deployment kit.
|
||||
2. Avoid exposing Ethernet ports unless required. Ethernet ports should remain disabled or physically blocked unless they are explicitly required for the deployment. When Ethernet access is necessary, its use should be clearly documented and limited to trusted operators.
|
||||
3. Use short internal cables to reduce easy probing
|
||||
4. Label power banks generically (avoid project names)
|
||||
|
||||
| USB & HDMI | Ethernet Ports |
|
||||
| --------------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
| .jpeg>) | .jpeg>) |
|
||||
|
||||
#### Environmental & Operational Practices
|
||||
|
||||
|
|
@ -106,8 +84,7 @@ Recommendations:
|
|||
* Store boxes in controlled locations when not in use
|
||||
* Rotate devices periodically in long deployments
|
||||
* Assume devices may be copied or lost
|
||||
* Treat Butter Boxes as semi-disposable infrastructure, not personal
|
||||
devices.
|
||||
* Treat Butter Boxes as semi-disposable infrastructure, not personal devices.<br/>
|
||||
|
||||
### Section 2: Digital Tamper Resistance
|
||||
|
||||
|
|
@ -119,27 +96,18 @@ SSH
|
|||
|
||||
* By default, the pi user has the password butterbox-admin.
|
||||
* Change this password by sshing into the pi and running passwd.
|
||||
* If you'd prefer to use an SSH key, be sure to disable password access once
|
||||
you enable key-based access.
|
||||
* If you'd prefer to use an SSH key, be sure to disable password access once you enable key-based access.
|
||||
|
||||
RaspAP
|
||||
|
||||
* The access point has an administrative interface that can be used to
|
||||
change its settings.
|
||||
* The access point has an administrative interface that can be used to change its settings.
|
||||
* Defaults: user: admin, password: secret (ironically, this is not secret).
|
||||
* Change this by logging in at
|
||||
[http://butterbox.lan/admin](http://butterbox.lan/admin) (or
|
||||
[http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin)
|
||||
for a Spanish language box) and using the Web UI.
|
||||
* Change this by logging in at[ http://butterbox.lan/admin](http://butterbox.lan/admin) (or[ http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin) for a Spanish language box) and using the Web UI.
|
||||
|
||||
Chat
|
||||
|
||||
* The local chat was created by an administrative user called
|
||||
butterbox-admin. The password for this user is also butterbox-admin.
|
||||
* Change this password by logging into the Butter Box, going to the public
|
||||
chatroom, then visiting your user profile and updating the password. At
|
||||
your discretion, you may also wish to change the name from butterbox-admin
|
||||
so that other users will recognize you.
|
||||
* The local chat was created by an administrative user called butterbox-admin. The password for this user is also butterbox-admin.
|
||||
* Change this password by logging into the Butter Box, going to the public chatroom, then visiting your user profile and updating the password. At your discretion, you may also wish to change the name from butterbox-admin so that other users will recognize you.
|
||||
|
||||
Best practices:
|
||||
|
||||
|
|
|
|||
|
|
@ -7,38 +7,28 @@ sidebar_position: 2
|
|||
|
||||
## Share Media, Files and Digital Books
|
||||
|
||||
You can use your Butter Box to share media, files, and digital books. To
|
||||
display additional content in your portal, connect a USB drive containing
|
||||
the information you want to share.
|
||||
You can use your Butter Box to share media, files, and digital books. To display additional content in your portal, connect a USB drive containing the information you want to share.
|
||||
|
||||
If you’d like more control over how your content is displayed, you can build
|
||||
a **static website** and share it through the Butter Box. Learn more in the
|
||||
[Content Packs](../content-packs/) section.
|
||||
If you’d like more control over how your content is displayed, you can build a **static website** and share it through the Butter Box. Learn more in the [Content Packs](../content-packs/) section.
|
||||
|
||||
|
||||
|
||||
### Add files to your USB Drive
|
||||
|
||||
Place individual files directly in the **main directory** (root) of your USB
|
||||
drive. Or, create folders to organize your files (eg. "Books", "Music",
|
||||
"Reports)
|
||||
Place individual files directly in the **main directory** (root) of your USB drive. Or, create folders to organize your files (eg. "Books", "Music", "Reports)
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.50.15 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
|
||||
**Things to Know**
|
||||
|
||||
* The **folder names you use** on your USB drive will be shown in the Butter
|
||||
Box portal.
|
||||
* Organizing content into folders makes it easier for others to browse and
|
||||
download.
|
||||
* The **folder names you use** on your USB drive will be shown in the Butter Box portal.
|
||||
* Organizing content into folders makes it easier for others to browse and download.
|
||||
|
||||
### Connect to your Butter Box to view
|
||||
|
||||
Insert the USB drive into your Butter Box. After connecting your USB drive
|
||||
to the Raspberry Pi you will see the **Files** tile displayed when you open
|
||||
the Butter Box portal.
|
||||
Insert the USB drive into your Butter Box. After connecting your USB drive to the Raspberry Pi you will see the **Files** tile displayed when you open the Butter Box portal.
|
||||
|
||||
<div><figure><img src="/img/docs/Screenshot_20260414-122810.png" alt=""/><figcaption></figcaption></figure> <figure><img src="/img/docs/Screenshot_20260414-122821.png" alt=""/><figcaption></figcaption></figure></div>
|
||||
<div><figure><img src="/img/docs/Screenshot_20260414-122810 (1).png" alt=""/><figcaption></figcaption></figure> <figure><img src="/img/docs/Screenshot_20260414-122821 (1).png" alt=""/><figcaption></figcaption></figure></div>
|
||||
|
||||
|
||||
|
||||
|
|
@ -50,8 +40,7 @@ If you don’t see the **Files** tile, try the following actions:
|
|||
* Turn on/off airplane mode. Reconnect Butter Box wifi.
|
||||
* Refresh the browser page.
|
||||
|
||||
If you are still having trouble you may need to [Reformat Your USB
|
||||
Drive](../faq/how-to-reformat-your-usb-drive).
|
||||
If you are still having trouble you may need to [Reformat Your USB Drive](../faq/how-to-reformat-your-usb-drive).
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,54 +1,44 @@
|
|||
---
|
||||
description: 'A place for anyone connected to the box to share'
|
||||
description: A place for anyone connected to the box to share
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Local Chat
|
||||
|
||||
There is one local chat on your Butter Box that is open to anyone who is
|
||||
able to join the box. If they can open the portal, they can open the chat
|
||||
and say or post anything they want. Depending on your use case, moderation
|
||||
capabilities may be important.
|
||||
There is one local chat on your Butter Box that is open to anyone who is able to join the box. If they can open the portal, they can open the chat and say or post anything they want. Depending on your use case, moderation capabilities may be important.
|
||||
|
||||
First, let's look at what you can and can't do with this local chat.
|
||||
|
||||
✅ **You Can**<br/>
|
||||
|
||||
* Host videos up to 5 GB PDFs, images, record, audio messages, share
|
||||
pre-recorded audio messages or music
|
||||
* Download the full chat or any individual piece of content or media that
|
||||
people have shared
|
||||
* Host videos up to 5 GB PDFs, images, record, audio messages, share pre-recorded audio messages or music
|
||||
* Download the full chat or any individual piece of content or media that people have shared
|
||||
|
||||
❌ **You Cannot**<br/>
|
||||
|
||||
* Use the chat to talk with people who are not connected to the Butter Box
|
||||
* Get notifications when there are new posts or messages
|
||||
* Get notifications when there are new posts or messages
|
||||
* See the messages unless you are connected to the Butter Box
|
||||
|
||||
|
||||
|
||||
## Moderation
|
||||
|
||||
A Butter Box offers moderation features for the local chat. In order to
|
||||
access these features, you need to login as the admin of the room.
|
||||
A Butter Box offers moderation features for the local chat. In order to access these features, you need to login as the admin of the room.
|
||||
|
||||
### Become the Admin
|
||||
|
||||
### Logout as Guest
|
||||
|
||||
When you open the local chat, you are assigned a guest identity. First
|
||||
logout of the account that was created for you.
|
||||
When you open the local chat, you are assigned a guest identity. First logout of the account that was created for you.
|
||||
|
||||
### Login as Admin
|
||||
|
||||
Login to the `butterbox-admin` account. Username and password are both
|
||||
`butterbox-admin`.
|
||||
Login to the `butterbox-admin` account. Username and password are both `butterbox-admin`.
|
||||
|
||||
### Change Admin Password
|
||||
|
||||
Visit your user profile to change the password. At your discretion, you may
|
||||
also wish to change your display name so that other users will recognize
|
||||
you.
|
||||
Visit your user profile to change the password. At your discretion, you may also wish to change your display name so that other users will recognize you.
|
||||
|
||||
### Moderation Features
|
||||
|
||||
|
|
@ -57,34 +47,27 @@ Once you are an admin, you have access to the following features:
|
|||
* **Set a message timer**
|
||||
* **Delete messages**
|
||||
* **Promote members to moderator or admin**
|
||||
* **Kick members out.**
|
||||
* Keep in mind that someone can simply rejoin as a new guest if they
|
||||
reconnect to the box
|
||||
* **Delete the room.**
|
||||
* Warning: If you delete the room, you will no longer have a local chat on
|
||||
your Butter Box. To get one back, you will have to flash a new image of
|
||||
the Butter Box software to your SD card.
|
||||
* **Kick members out.**
|
||||
* Keep in mind that someone can simply rejoin as a new guest if they reconnect to the box
|
||||
* **Delete the room.**
|
||||
* Warning: If you delete the room, you will no longer have a local chat on your Butter Box. To get one back, you will have to flash a new image of the Butter Box software to your SD card.
|
||||
|
||||
|
||||
|
||||
## Say Even More—Direct Messages and Private Rooms
|
||||
|
||||
In addition to the local chat, you can create any number of private rooms
|
||||
from the same interface.
|
||||
In addition to the local chat, you can create any number of private rooms from the same interface.
|
||||
|
||||
### Things To Know
|
||||
|
||||
* Each room will have it's own QR code.
|
||||
* Each room will have it's own QR code.
|
||||
* Private rooms are not discoverable from the Butter Box portal.
|
||||
* If you create a private room, you have to share the QR code physically to
|
||||
whomever you want to join **who is also connected to the box.**
|
||||
* Every private chat that you are part of, will be easy for **you** to
|
||||
find. They will all show up in your room list.
|
||||
* If you create a private room, you have to share the QR code physically to whomever you want to join **who is also connected to the box.**
|
||||
* Every private chat that you are part of, will be easy for **you** to find. They will all show up in your room list.
|
||||
|
||||
### Instructions
|
||||
|
||||
You can create a private room from two different places in the message board
|
||||
interface.
|
||||
You can create a private room from two different places in the message board interface.
|
||||
|
||||
### Open from Avatar Modal
|
||||
|
||||
|
|
@ -97,8 +80,7 @@ Tap on your avatar in the top bar. Select **new room.**
|
|||
|
||||
### Open from Room List
|
||||
|
||||
Your room list is accessible from your profile page. Once here, select **new
|
||||
room.**
|
||||
Your room list is accessible from your profile page. Once here, select **new room.**
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-01-20 at 1.42.17 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
|
|
|||
|
|
@ -1,17 +1,11 @@
|
|||
---
|
||||
description: 'Using Delta Chat with a Butter Box'
|
||||
description: Using Delta Chat with a Butter Box
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Private Messenger
|
||||
|
||||
With the Private Messenger service, you can exchange secure messages with
|
||||
people you know. [Delta Chat](https://delta.chat/) is a messaging app that
|
||||
uses email protocols to exchange messages. When used through a Butter Box,
|
||||
people who create accounts on the same Butter Box can send messages to each
|
||||
other without the internet.
|
||||
With the Private Messenger service, you can exchange secure messages with people you know. [Delta Chat](https://delta.chat/) is a messaging app that uses email protocols to exchange messages. When used through a Butter Box, people who create accounts on the same Butter Box can send messages to each other without the internet.
|
||||
|
||||
Think of the Butter Box like a local post office. Whenever you connect to
|
||||
the Box’s network, your Delta Chat app can send outgoing messages and sync
|
||||
to receive any new ones waiting for you.
|
||||
Think of the Butter Box like a local post office. Whenever you connect to the Box’s network, your Delta Chat app can send outgoing messages and sync to receive any new ones waiting for you.
|
||||
|
||||
|
|
|
|||
|
|
@ -13,14 +13,10 @@ Always choose the Latest Version of the file
|
|||
|
||||
### Early Access Development Releases
|
||||
|
||||
WARNING: These are early releases posted for development testing and MUST
|
||||
NOT be used in production deployments.
|
||||
WARNING: These are early releases posted for development testing and MUST NOT be used in production deployments.
|
||||
|
||||
[Download Early Access Development
|
||||
Images](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list)
|
||||
[Download Early Access Development Images](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list)
|
||||
|
||||
### Update your Butter Box
|
||||
|
||||
Update your Butter Box using the same guide with the steps you take when you
|
||||
are setting a Butter Box up for the first time. You can find it here:
|
||||
[Raspberry Pi Install](build-a-box/raspberry-pi/install-butter)
|
||||
Update your Butter Box using the same guide with the steps you take when you are setting a Butter Box up for the first time. You can find it here: [Raspberry Pi Install](build-a-box/raspberry-pi/install-butter)
|
||||
|
|
|
|||
|
|
@ -1,23 +1,24 @@
|
|||
---
|
||||
description: 'DIY instructions'
|
||||
title: "Сборка Butter Box"
|
||||
nav_order: 3
|
||||
has_children: true
|
||||
permalink: /build-a-box/
|
||||
---
|
||||
|
||||
# Build A Box
|
||||
# Сборка Butter Box
|
||||
|
||||
Don’t have a Butter Box yet? You can easily build your own. Choose your
|
||||
setup to get started.
|
||||
Ещё нет Butter Box? Вы можете легко собрать своё устройство. Выберите конфигурацию, чтобы начать.
|
||||
|
||||
## Butter Box Setups
|
||||
## Конфигурации Butter Box
|
||||
|
||||
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.
|
||||
Программное обеспечение Butter Box в настоящее время работает на устройствах Raspberry Pi: Pi Zero 2 и Pi 4. Вы можете использовать любое из них. Подробности в сравнительной таблице ниже.
|
||||
|
||||
| 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_ |
|
||||
| <strong>Базовая</strong> Raspberry Pi Zero Pi 2<br/><br/><a href="raspberry-pi/basic-box-supplies.mdx">Начать</a> | До 10 человек, на расстоянии около 10 метров | [Список комплектующих](raspberry-pi/basic-box-supplies.mdx) |
|
||||
| <strong>Расширенная</strong> Raspberry Pi 4 в связке с роутером<br/><br/><a href="raspberry-pi/extend-your-box.mdx">Начать</a> | До 20 человек, на расстоянии около 30 метров при использовании с роутером | [Список комплектующих](raspberry-pi/extend-your-box.mdx) |
|
||||
| ПК/Ноутбук (amd64) | _Скоро будет_ | _Скоро будет_ |
|
||||
|
||||
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.
|
||||
Мы также изготавливаем и отправляем Butter Box партнёрам по всему миру.
|
||||
Если вы работаете с сообществом, которому это может быть полезно, мы будем рады сотрудничеству.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,69 +1,8 @@
|
|||
---
|
||||
description: 'How to turn an old PC into golden deliciuos butter!'
|
||||
sidebar_position: 2
|
||||
title: "ПК/Ноутбук"
|
||||
nav_order: 2
|
||||
parent: "Сборка Butter Box"
|
||||
---
|
||||
|
||||
# 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!)
|
||||
|
||||
# ПК/Ноутбук
|
||||
|
||||
|
|
|
|||
|
|
@ -1,27 +1,19 @@
|
|||
---
|
||||
description: 'Different ways to power your Butter Box'
|
||||
sidebar_position: 3
|
||||
title: "Источник питания"
|
||||
nav_order: 3
|
||||
parent: "Сборка Butter Box"
|
||||
---
|
||||
|
||||
# Источник питания
|
||||
|
||||
Если вы хотите, чтобы Butter Box работал полностью автономно и без
|
||||
электричества — это возможно! Butter Box может работать от розетки, от
|
||||
предварительно заряженного аккумулятора или от аккумулятора с солнечной
|
||||
панелью.
|
||||
Если вы хотите, чтобы Butter Box работал полностью автономно и без электричества — это возможно!
|
||||
Butter Box может работать от розетки, от предварительно заряженного аккумулятора или от аккумулятора с солнечной панелью.
|
||||
|
||||
* **Розетка:** Официальный и рекомендуемый блок питания для компьютеров
|
||||
Raspberry Pi (зависит от используемой модели Raspberry Pi)
|
||||
* **Предварительно заряженный аккумулятор (Power Bank):** Это наиболее
|
||||
распространённый вариант для использования в полевых условиях.
|
||||
* Портативное зарядное устройство Anker [power
|
||||
bank](https://www.ozon.ru/product/zaryadnoe-ustroystvo-anker-nano-charger-45w-chernyy-a2692l11-3298658513/),
|
||||
* **Солнечная панель (с Power Bank):** Используйте небольшую солнечную
|
||||
панель для подзарядки вашего power bank. Это хороший вариант для
|
||||
непрерывной работы устройства в местах без электросети. Использование
|
||||
солнечной панели напрямую без аккумулятора возможно, но нестабильно при
|
||||
переменной облачности.
|
||||
* Комплекты солнечных панелей:
|
||||
[ozon.ru](https://www.ozon.ru/search/?text=%D0%A1%D0%BE%D0%BB%D0%BD%D0%B5%D1%87%D0%BD%D0%B0%D1%8F+%D0%BF%D0%B0%D0%BD%D0%B5%D0%BB%D1%8C+%D1%81%D0%BA%D0%BB%D0%B0%D0%B4%D0%BD%D0%B0%D1%8F&from_global=true)
|
||||
* **Розетка:** Официальный и рекомендуемый блок питания для компьютеров Raspberry Pi (зависит от используемой модели Raspberry Pi)
|
||||
* **Предварительно заряженный аккумулятор (Power Bank):** Это наиболее распространённый вариант для использования в полевых условиях.
|
||||
* Портативное зарядное устройство Anker [power bank](https://www.ozon.ru/product/zaryadnoe-ustroystvo-anker-nano-charger-45w-chernyy-a2692l11-3298658513/),
|
||||
[power bank](https://aliexpress.ru/item/1005011864808436.html)
|
||||
* **Солнечная панель (с Power Bank):** Используйте небольшую солнечную панель для подзарядки вашего power bank. Это хороший вариант для непрерывной работы устройства в местах без электросети. Использование солнечной панели напрямую без аккумулятора возможно, но нестабильно при переменной облачности.
|
||||
* Комплекты солнечных панелей: [ozon.ru](https://www.ozon.ru/search/?text=%D0%A1%D0%BE%D0%BB%D0%BD%D0%B5%D1%87%D0%BD%D0%B0%D1%8F+%D0%BF%D0%B0%D0%BD%D0%B5%D0%BB%D1%8C+%D1%81%D0%BA%D0%BB%D0%B0%D0%B4%D0%BD%D0%B0%D1%8F&from_global=true)
|
||||
|
||||
<figure><img src="../.gitbook/assets/Screenshot 2025-07-31 at 10.55.41 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
|
|
|||
|
|
@ -1,51 +1,36 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
title: "Основные комплектующие"
|
||||
nav_order: 1
|
||||
parent: "Raspberry Pi"
|
||||
grand_parent: "Сборка Butter Box"
|
||||
---
|
||||
|
||||
# Основные комплектующие
|
||||
|
||||
Базовая конфигурация Butter Box — это Raspberry Pi Zero 2 W с картой
|
||||
microSD, на которой установлено программное обеспечение Butter,
|
||||
USB-накопитель и питание от USB-источника, такого как блок питания, power
|
||||
bank или солнечная панель.
|
||||
Базовая конфигурация Butter Box — это Raspberry Pi Zero 2 W с картой microSD, на которой установлено программное обеспечение Butter, USB-накопитель и питание от USB-источника, такого как блок питания, power bank или солнечная панель.
|
||||
|
||||
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.
|
||||
В большинстве таких конфигураций Butter Box может комфортно обслуживать **от 4 до 10 подключённых устройств одновременно** без замедления. Возможно подключить и больше, но производительность может снизиться, если все одновременно загружают большие файлы или видео.
|
||||
|
||||
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.
|
||||
Радиус действия составляет около **5–10 метров** в помещении, в зависимости от модели Raspberry Pi, а также от стен и помех. На открытом воздухе, на открытом пространстве, он иногда может быть больше. Представьте себе радиус действия домашнего Wi-Fi роутера — достаточно, чтобы покрыть класс, кафе, переговорную комнату или небольшое мероприятие на открытом воздухе.
|
||||
|
||||
## Комплектующие
|
||||
|
||||
* [ ] Raspberry Pi Zero 2W (64 Bit)
|
||||
[ozon.ru/product/raspberry-pi-zero-2-w-c-wifi-i-bluetooth-mikrokompyuter-rasberi-malina-1069765865](https://ozon.ru/product/raspberry-pi-zero-2-w-c-wifi-i-bluetooth-mikrokompyuter-rasberi-malina-1069765865);
|
||||
Или вы можете купить комплект здесь:
|
||||
[ozon.ru/product/kompyuter-v-sborke-2136359684](https://ozon.ru/product/kompyuter-v-sborke-2136359684)
|
||||
* [ ] Блок питания с кабелем, входящие в комплект Raspberry Pi Zero 2W, или
|
||||
[альтернативный источник питания](../power-supply.mdx)
|
||||
* [ ] Карта Micro SD: Образы с программным обеспечением Butter обычно
|
||||
занимают менее 16 ГБ (мы рекомендуем 256 ГБ). Медиафайлы, которые люди
|
||||
загружают в чат, сохраняются на карте; они никогда не удаляются.
|
||||
|
||||
|
||||
* [ ] Raspberry Pi Zero 2W (64 Bit) [ozon.ru/product/raspberry-pi-zero-2-w-c-wifi-i-bluetooth-mikrokompyuter-rasberi-malina-1069765865](https://ozon.ru/product/raspberry-pi-zero-2-w-c-wifi-i-bluetooth-mikrokompyuter-rasberi-malina-1069765865); Или вы можете купить комплект здесь: [ozon.ru/product/kompyuter-v-sborke-2136359684](https://ozon.ru/product/kompyuter-v-sborke-2136359684)
|
||||
* [ ] Блок питания с кабелем, входящие в комплект Raspberry Pi Zero 2W, или [альтернативный источник питания](../power-supply.mdx)
|
||||
* [ ] Карта Micro SD: Образы с программным обеспечением Butter обычно занимают менее 16 ГБ (мы рекомендуем 256 ГБ). Медиафайлы, которые люди загружают в чат, сохраняются на карте; они никогда не удаляются.
|
||||
* [ ] USB-накопитель (минимум 32 ГБ)
|
||||
* [ ] Адаптеры (по необходимости)
|
||||
|
||||
* [ ] Micro USB/штекер на USB A/гнездо
|
||||
* [ ] Переходник для подключения карты micro SD к вашему ноутбуку (если
|
||||
необходимо)
|
||||
|
||||
* [ ] Переходник для подключения карты micro SD к вашему ноутбуку (если необходимо)
|
||||
|
||||
|
||||
**Когда у вас будут все комплектующие, переходите к разделу «Установка Butter».**
|
||||
|
||||
[install-butter.md](install-butter)
|
||||
|
||||
<figure><img src="/img/docs/20250815_142828.jpg" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
[install-butter.md](install-butter.mdx)
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,72 +1,64 @@
|
|||
---
|
||||
description: 'How To Add a Router To Your Box Setup'
|
||||
sidebar_position: 4
|
||||
title: "Апгрейд Butter Box"
|
||||
nav_order: 3
|
||||
parent: "Raspberry Pi"
|
||||
grand_parent: "Сборка Butter Box"
|
||||
---
|
||||
|
||||
# Апгрейд Butter Box
|
||||
|
||||
Butter Box с увеличенным радиусом действия объединяет Raspberry Pi с
|
||||
отдельным Wi-Fi маршрутизатором, обеспечивая более сильный сигнал и большее
|
||||
количество одновременных подключений.
|
||||
Butter Box с увеличенным радиусом действия объединяет Raspberry Pi с отдельным Wi-Fi маршрутизатором, обеспечивая более сильный сигнал и большее количество одновременных подключений.
|
||||
|
||||
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.
|
||||
С маршрутизатором сеть может охватывать 10-30 м и комфортно поддерживать 10–20 подключённых устройств одновременно. Эта конфигурация идеально подходит для средней группы людей в помещении среднего размера, например, в учебных классах, на мероприятиях или в общественных пространствах.
|
||||
|
||||
## Комплектующие
|
||||
## Необходимые материалы
|
||||
|
||||
* [ ] Raspberry Pi 4, 5 или Raspberry Pi Zero 2W
|
||||
* [ ] Маршрутизатор ([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)
|
||||
или аналог)
|
||||
* [ ] Блок питания и кабели питания для Raspberry Pi и маршрутизатора или
|
||||
[альтернативный источник питания](../power-supply.mdx)
|
||||
* [ ] Карта Micro SD: Образы с программным обеспечением Butter обычно
|
||||
занимают менее 16 ГБ (мы рекомендуем 256 ГБ). Медиафайлы, которые люди
|
||||
загружают в чат, сохраняются на карте; они никогда не удаляются.
|
||||
* [ ] Маршрутизатор ([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) или аналог)
|
||||
* [ ] Блок питания и кабели питания для Raspberry Pi и маршрутизатора или [альтернативный источник питания](../power-supply.mdx)
|
||||
* [ ] Карта Micro SD: образы с программным обеспечением Butter обычно занимают менее 16 ГБ (мы рекомендуем Micro SD карту 256 ГБ). Медиафайлы, которые пользователи загружают в чат, сохраняются на карте и никогда не удаляются.
|
||||
* [ ] USB-накопитель (минимум 32 ГБ)
|
||||
* [ ] Адаптеры (по необходимости)
|
||||
* [ ] Адаптеры (при необходимости)
|
||||
|
||||
_Подключение к интернету не требуется._
|
||||
|
||||
<figure><img src="/img/docs/20250815_142438.jpg" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
|
||||
|
||||
## Шаги
|
||||
|
||||
Чтобы увиличить радиус действия вашего Butter Box, просто подключите
|
||||
маршрутизатор GLi-Net к Butter Box с помощью кабеля Ethernet. Вместо доступа
|
||||
к коробке через портальную точку доступа Wi-Fi (например, ‘butter box’ или
|
||||
любое имя, которое вы задали в настройках администратора), пользователи
|
||||
будут подключаться к сети Wi-Fi маршрутизатора.
|
||||
Чтобы увиличить радиус действия вашего Butter Box, просто подключите маршрутизатор GLi-Net к Butter Box с помощью кабеля Ethernet. Вместо доступа к коробке через портальную точку доступа Wi-Fi (например, ‘butter box’ или любое имя, которое вы задали в настройках администратора), пользователи будут подключаться к сети Wi-Fi маршрутизатора.
|
||||
|
||||
|
||||
### Подключите Butter Box к источнику питания.
|
||||
|
||||
Подключите Butter Box к питанию.
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Подключите маршрутизатор
|
||||
|
||||
Подключите маршрутизатор к питанию. Затем используйте кабель Ethernet для
|
||||
подключения к Butter Box. Убедитесь, что кабель Ethernet подключён к порту
|
||||
LAN на вашем маршрутизаторе.
|
||||
Подключите маршрутизатор к питанию. Затем используйте кабель Ethernet для подключения к Butter Box. Убедитесь, что кабель Ethernet подключён к порту LAN на вашем маршрутизаторе.
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Проверьте подключение
|
||||
|
||||
Подключитесь к Wi-Fi маршрутизатора. Если вы ещё не настраивали и не
|
||||
использовали этот маршрутизатор, введите пароль по умолчанию, указанный в
|
||||
руководстве пользователя, входящем в комплект. Через 30 секунд откройте
|
||||
http://butterbox.local в браузере.
|
||||
Подключитесь к Wi-Fi маршрутизатора. Если вы ещё не настраивали и не использовали этот маршрутизатор, введите пароль по умолчанию, указанный в руководстве пользователя, входящем в комплект. Через 30 секунд откройте http://butterbox.local в браузере.
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Отключите точку доступа Wi-Fi Butter Box
|
||||
|
||||
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.
|
||||
Откройте настройки администратора на портале Butter Box. Перейдите в раздел **Безопасный портал**. Отключите точку доступа Wi-Fi. Это скроет сеть Wi-Fi, транслируемую Raspberry Pi, чтобы пользователи не путались, к какой сети подключаться.
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Пригласите пользователей подключиться к Wi-Fi маршрутизатора
|
||||
|
||||
Теперь пользователи будут подключаться к сети Wi-Fi маршрутизатора, когда
|
||||
захотят подключиться к Butter Box.
|
||||
Теперь пользователи будут подключаться к сети Wi-Fi маршрутизатора, когда захотят подключиться к Butter Box.
|
||||
|
||||
|
|
|
|||
|
|
@ -1,5 +1,10 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
title: "Raspberry Pi"
|
||||
nav_order: 1
|
||||
parent: "Сборка Butter Box"
|
||||
has_children: true
|
||||
permalink: /build-a-box/raspberry-pi/
|
||||
---
|
||||
|
||||
# Raspberry Pi
|
||||
|
||||
|
|
|
|||
|
|
@ -1,6 +1,8 @@
|
|||
---
|
||||
description: 'Install Butter Operating System (OS) on an SD card for Raspberry Pi'
|
||||
sidebar_position: 3
|
||||
title: "Установка Butter"
|
||||
nav_order: 2
|
||||
parent: "Raspberry Pi"
|
||||
grand_parent: "Сборка Butter Box"
|
||||
---
|
||||
|
||||
# Установка Butter
|
||||
|
|
@ -11,92 +13,100 @@ sidebar_position: 3
|
|||
* Подключение к интернету
|
||||
* Butter Box
|
||||
|
||||
|
||||
### Скачайте Butter OS для Raspberry Pi
|
||||
|
||||
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда
|
||||
браузеры не завершают загрузку, что может привести к повреждению файла.
|
||||
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда браузеры не завершают загрузку, что может привести к повреждению файла.
|
||||
|
||||
[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
|
||||
Всегда выбирайте последнюю версию файла.
|
||||
:::
|
||||
> **Информация:**
|
||||
> Всегда выбирайте последнюю версию файла.
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Вставьте карту micro SD в компьютер
|
||||
|
||||
Чтобы вставить карту micro SD в компьютер, вам может понадобиться адаптер:
|
||||
|
||||
<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
|
||||
Подключать коробку к компьютеру не нужно.
|
||||
:::
|
||||
|
||||
### Запустите Raspberry Pi Imager
|
||||
|
||||
После того как вы вставили карту micro SD в компьютер с подключением к
|
||||
интернету, запустите Raspberry Pi Imager на настольном компьютере. Программа
|
||||
проведёт вас через шаги установки операционной системы Butter на карту micro
|
||||
SD.
|
||||
После того как вы вставили карту micro SD в компьютер с подключением к интернету, запустите Raspberry Pi Imager на настольном компьютере. Программа проведёт вас через шаги установки операционной системы Butter на карту micro SD.
|
||||
|
||||
Если у вас нет Raspberry Pi Imager, вы можете скачать его здесь: [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)
|
||||
|
||||
---
|
||||
|
||||
Если у вас нет Raspberry Pi Imager, вы можете скачать его здесь:
|
||||
[https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)
|
||||
|
||||
### Выберите устройство > **Raspberry Pi Zero 2 W**
|
||||
|
||||
После запуска Raspberry Pi Imager вам будет предложено выбрать устройство
|
||||
Raspberry Pi.
|
||||
После запуска Raspberry Pi Imager вам будет предложено выбрать устройство Raspberry Pi.
|
||||
|
||||
<img src="../../.gitbook/assets/Screenshot 2026-02-24 at 9.56.27 AM.png" alt=""/>
|
||||
<p>Выберите Raspberry Pi Zero 2 W (или другое устройство, если у вас не стандартная коробка от Butter HQ)</p>
|
||||
---
|
||||
|
||||
<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>
|
||||
|
||||
### Выберите операционную систему > Use Custom
|
||||
|
||||
* На вкладке ОС выберите **Use Custom** и загрузите файл butter-******.img
|
||||
Убедитесь, что вы **распаковали файл xz** перед использованием.
|
||||
* На вкладке ОС выберите **Use Custom** и загрузите файл butter-******.img Убедитесь, что вы **распаковали файл xz** перед использованием.
|
||||
|
||||
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 9.57.31 AM.png" alt=""/><figcaption><p>Выберите «Use Custom». Выберите файл .img, который скачали с Dropbox.</p></figcaption></figure>
|
||||
|
||||
---
|
||||
|
||||
<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>
|
||||
|
||||
### Выберите хранилище > Выберите карту Micro SD
|
||||
|
||||
* На вкладке **Хранилище** выберите **карту Micro SD.**
|
||||
|
||||
<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>
|
||||
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.27.37 PM.png" alt=""/><figcaption><p>Выберите карту Micro SD.</p></figcaption></figure>
|
||||
|
||||
После того как вы всё выбрали, ваш экран будет выглядеть примерно так:
|
||||
|
||||
<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>
|
||||
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.27.43 PM.png" alt=""/><figcaption><p>Финальный экран после выбора.</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”_.
|
||||
Вам может быть показано сообщение _«Doing this will erase all data from selected external storage»_ и _«do you want to apply settings?»_, нажмите _«no, clear settings»_.
|
||||
|
||||
После этого выберите _«write»_ и начните процесс записи на карту Micro SD.
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Извлеките из компьютера и вставьте карту Micro SD в Raspberry Pi (Butter Box)
|
||||
|
||||
По завершении извлеките карту Micro SD. Вставьте карту Micro SD в Raspberry
|
||||
Pi (Butter Box), который не подключён к питанию.
|
||||
По завершении извлеките карту Micro SD. Вставьте карту Micro SD в Raspberry Pi (Butter Box), который не подключён к питанию.
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Перейдите к быстрому старту
|
||||
|
||||
Подключите Raspberry Pi (Butter Box) к питанию. Подождите несколько
|
||||
мгновений и подключитесь к порталу Butter Box. Перейдите в раздел [Быстрый
|
||||
старт](../../quick-start.mdx) для получения дополнительной информации.
|
||||
Подключите Raspberry Pi (Butter Box) к питанию. Подождите несколько мгновений и подключитесь к порталу Butter Box. Перейдите в раздел [Быстрый старт](../../quick-start.mdx) для получения дополнительной информации.
|
||||
|
||||
---
|
||||
|
||||
**Если вы собираете улучшенный Butter Box (с увеличенным радиусом действия), перейдите к следующему разделу: Апгрейд Butter Box.**
|
||||
|
||||
[extend-your-box.md](extend-your-box)
|
||||
|
||||
[extend-your-box.md](extend-your-box.mdx)
|
||||
|
||||
|
||||
### Устранение неполадок
|
||||
|
||||
Если вы видите ошибку, указывающую, что входной файл не является допустимым
|
||||
образом диска, проверьте скачанный файл.
|
||||
Если вы видите ошибку, указывающую, что входной файл не является допустимым образом диска, проверьте скачанный файл.
|
||||
|
||||
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда
|
||||
браузеры не завершают загрузку, что может привести к повреждению файла.
|
||||
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда браузеры не завершают загрузку, что может привести к повреждению файла.
|
||||
|
||||
Также убедитесь, что вы **распаковали файл** перед использованием.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.28.37 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.28.37 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
|
|
|||
|
|
@ -1,26 +0,0 @@
|
|||
---
|
||||
description: 'Different ways to power your Butter Box'
|
||||
---
|
||||
|
||||
# Источник питания
|
||||
|
||||
Если вы хотите, чтобы Butter Box работал полностью автономно и без
|
||||
электричества — это возможно! Butter Box может работать от розетки, от
|
||||
предварительно заряженного аккумулятора или от аккумулятора с солнечной
|
||||
панелью.
|
||||
|
||||
* **Розетка:** Официальный и рекомендуемый блок питания для компьютеров
|
||||
Raspberry Pi (зависит от используемой модели Raspberry Pi)
|
||||
* **Предварительно заряженный аккумулятор (Power Bank):** Это наиболее
|
||||
распространённый вариант для использования в полевых условиях.
|
||||
* Портативное зарядное устройство Anker [power
|
||||
bank](https://www.ozon.ru/product/zaryadnoe-ustroystvo-anker-nano-charger-45w-chernyy-a2692l11-3298658513/),
|
||||
* **Солнечная панель (с Power Bank):** Используйте небольшую солнечную
|
||||
панель для подзарядки вашего power bank. Это хороший вариант для
|
||||
непрерывной работы устройства в местах без электросети. Использование
|
||||
солнечной панели напрямую без аккумулятора возможно, но нестабильно при
|
||||
переменной облачности.
|
||||
* Комплекты солнечных панелей:
|
||||
[ozon.ru](https://www.ozon.ru/search/?text=%D0%A1%D0%BE%D0%BB%D0%BD%D0%B5%D1%87%D0%BD%D0%B0%D1%8F+%D0%BF%D0%B0%D0%BD%D0%B5%D0%BB%D1%8C+%D1%81%D0%BA%D0%BB%D0%B0%D0%B4%D0%BD%D0%B0%D1%8F&from_global=true)
|
||||
|
||||
<figure><img src="../.gitbook/assets/Screenshot 2025-07-31 at 10.55.41 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
|
@ -1,18 +1,20 @@
|
|||
---
|
||||
sidebar_position: 9
|
||||
title: "Примеры использования"
|
||||
nav_order: 9
|
||||
---
|
||||
# Use Cases
|
||||
|
||||
### 1. Digital Security training to distribute apps and materials
|
||||
# Примеры использования
|
||||
|
||||
> Leaders from Southern Africa countries travel to provide training, audits, and consultations to organizations about digital security, physical safety, risk assessments, and to equip journalists, activists and human rights defenders with the tools and knowledge to do their job safer. In order to do their work effectively, these leaders need to be able to curate specific types of content to fit various use cases, in different contexts and languages and different formats. In offline situations (load shedding, no access to the internet or in times of internet shutdowns) the ability to successfully deliver trainings and content becomes almost impossible. \
|
||||
### 1. Тренинги по цифровой безопасности для распространения приложений и материалов
|
||||
|
||||
> Лидеры из стран Южной Африки путешествуют для проведения тренингов, аудитов и консультаций для организаций по вопросам цифровой безопасности, физической безопасности, оценки рисков, а также для оснащения журналистов, активистов и правозащитников инструментами и знаниями для более безопасного выполнения их работы. Для эффективной работы этим лидерам необходима возможность подбирать определённые типы контента для различных сценариев использования, в разных контекстах и на разных языках и в разных форматах. В офлайн-ситуациях (отключения электричества, отсутствие доступа к интернету или во время отключений интернета) возможность успешно проводить тренинги и доставлять контент становится практически невозможной. \
|
||||
> \
|
||||
> They shared more than a few times that if they did not have the Butter Box, some sessions would have been canceled.
|
||||
> Они неоднократно отмечали, что если бы у них не было Butter Box, некоторые сессии пришлось бы отменить.
|
||||
|
||||
### 2. Sharing & Media Backup
|
||||
### 2. Обмен файлами и резервное копирование медиа
|
||||
|
||||
> Often M. wants to share music and movie files that they’ve downloaded on their computer with their friends — but transferring with cables or Bluetooth is a pain. So they've set up a Butter Box with their media collection — music files, films and photos. They plugged it in near the kitchen, and now anyone in their apartment can connect to the Butter Wi‑Fi and browse a shared media library. No internet needed, and no more file-by-file transfers.
|
||||
> Часто М. хочет поделиться музыкальными и видеофайлами, которые они загрузили на свой компьютер, с друзьями — но передача через кабели или Bluetooth — это мучение. Поэтому они настроили Butter Box со своей медиаколлекцией — музыкальные файлы, фильмы и фотографии. Они подключили его рядом с кухней, и теперь любой в их квартире может подключиться к Wi-Fi Butter и просматривать общую медиатеку. Интернет не нужен, и больше никаких поштучных передач файлов.
|
||||
|
||||
### 3. Temporary file storage
|
||||
### 3. Временное хранение файлов
|
||||
|
||||
> On a remote site with no cell service, workers needed a way to temporarily offload large files — like site photos or documents — from their phones. Using Butter Box’s local encrypted message board, they sent files to themselves or coworkers for safekeeping. Files stayed on the device until retrieved later, even without power or signal.
|
||||
> На удалённом объекте без сотовой связи рабочим нужен был способ временно выгрузить большие файлы — например, фотографии объекта или документы — со своих телефонов. Используя локальную зашифрованную доску сообщений Butter Box, они отправляли файлы себе или коллегам на хранение. Файлы оставались на устройстве до их получения позже, даже без питания или сигнала.
|
||||
|
|
|
|||
|
|
@ -1,160 +0,0 @@
|
|||
---
|
||||
description: 'How to Create Your Own F-Droid Repo to Share as a Content Pack'
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# F-Droid Repo
|
||||
|
||||
You can build your own curated F-Droid repo using your computer's
|
||||
terminal. Once set up, users can connect their F-Droid app to your Butter
|
||||
Box and start downloading apps.
|
||||
|
||||
|
||||
|
||||
### Step 1: Install F-Droid Server Tools
|
||||
|
||||
Before you begin, you need to install a tool called **fdroidserver**. This
|
||||
helps you create and manage your app store.
|
||||
|
||||
**On Mac (using Homebrew):**
|
||||
|
||||
```
|
||||
brew install fdroidserver
|
||||
```
|
||||
|
||||
**On Linux (Debian/Ubuntu):**
|
||||
|
||||
```
|
||||
sudo apt install fdroidserver
|
||||
```
|
||||
|
||||
### Step 2: Check that it's installed correctly
|
||||
|
||||
After installation, run this command:
|
||||
|
||||
```
|
||||
fdroid version
|
||||
```
|
||||
|
||||
If everything is working, you will see a version number printed on the
|
||||
screen.
|
||||
|
||||
### Step 3: Create Your Repo Folder
|
||||
|
||||
You need to create the folder where you will save the repo files in your
|
||||
computer, choose a name that aligns with the project or purpose of the apps
|
||||
in it, and replace my-fdroid-repo for that name in the command.
|
||||
|
||||
```
|
||||
mkdir -p ~/my-fdroid-repo
|
||||
```
|
||||
|
||||
```
|
||||
cd ~/my-fdroid-repo
|
||||
```
|
||||
|
||||
### Step 4: Initialize the repo
|
||||
|
||||
```
|
||||
fdroid init
|
||||
```
|
||||
|
||||
This creates the following directories in your repo file:
|
||||
|
||||
```
|
||||
Config.yml
|
||||
```
|
||||
|
||||
```
|
||||
repo/
|
||||
```
|
||||
|
||||
```
|
||||
metadata/
|
||||
```
|
||||
|
||||
### Step 5: Add your APKs
|
||||
|
||||
Copy your signed APKs into the repo/ folder. Ensure you only use apps from
|
||||
trusted sources like the official F-Droid library or verified developers.
|
||||
|
||||
**Security Note:** Avoid downloading APKs from "mirror" sites or unknown sources, as they can contain malware or trackers that compromise your users' privacy.
|
||||
|
||||
```
|
||||
cp /path/to/your/*.apk repo/
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```
|
||||
cp ~/Downloads/myapp.apk repo/
|
||||
```
|
||||
|
||||
### Step 6: Generate (and Update) the Repository Index
|
||||
|
||||
Every time you add a new APK or a new version of an app to your repo/
|
||||
folder, you must run the following command to "publish" those changes:
|
||||
|
||||
```
|
||||
fdroid update --create-metadata
|
||||
```
|
||||
|
||||
What this command does:
|
||||
|
||||
* **Scans APKs:** It reads the new files in your repo/ folder.
|
||||
* **Generates Metadata:** It creates YAML files containing the app's name,
|
||||
version, and permissions.
|
||||
* **Creates index.v1.jar:** This is the "catalog" file that the F-Droid app
|
||||
downloads to see what is available.
|
||||
* **Signs the Repository:** It uses your secret key to sign the index,
|
||||
proving to the Android app that the files haven't been tampered with.
|
||||
|
||||
### Step 7: Test your Repo locally
|
||||
|
||||
To test your repo locally and ensure everything works before you share it on
|
||||
the Butter Box, you can serve its content locally and add it to F-Droid
|
||||
using a URL.
|
||||
|
||||
```
|
||||
cd repo
|
||||
```
|
||||
|
||||
```
|
||||
python3 -m http.server 8000
|
||||
```
|
||||
|
||||
Once your repo is live, open the F-Droid app on your device and navigate to **Settings > Repositories > "+"**. Select **"Enter repository URL manually"** to add your new source.
|
||||
|
||||
Adding the repo manually allows you to verify the user experience by
|
||||
checking:
|
||||
|
||||
* **App Visibility:** Are all your apps appearing in the list?
|
||||
* **Visual Assets:** Are icons and screenshots displaying correctly?
|
||||
* **Categorization:** Are apps appearing in the correct sections (e.g.,
|
||||
Internet, Security)?
|
||||
* **Functionality:** Do the downloads and installations complete without
|
||||
errors?
|
||||
* **Metadata:** Does the version number and description match your `repo/`
|
||||
files?
|
||||
|
||||
|
||||
|
||||
Your repo will be available at:
|
||||
|
||||
`http://YOUR-IP:8000/repo`
|
||||
|
||||
|
||||
|
||||
**Find your IP:**
|
||||
|
||||
#### macOS:
|
||||
|
||||
```
|
||||
ipconfig getifaddr en0
|
||||
```
|
||||
|
||||
#### Linux:
|
||||
|
||||
```
|
||||
hostname -I
|
||||
```
|
||||
|
|
@ -1,50 +0,0 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Apps
|
||||
|
||||
You can share apps as a content pack, via a static website. If you give a
|
||||
folder the name `appstore` and place it in the root directory of the USB
|
||||
drive, the **Apps** tile will appear in the Butter Box portal.
|
||||
|
||||
**Things To Know**
|
||||
|
||||
* If you are sharing apps from Butter Box, you will need to download the app
|
||||
files you want to share. Apps are updated frequently. Be sure to manually
|
||||
update all of the app files frequently to ensure you are providing the
|
||||
highest security for the people who connect to the box.
|
||||
* You’ll need a copy of the app’s `.apk` file — make sure it’s from a safe
|
||||
and trusted source.
|
||||
* Butter won’t automatically verify the source, so it's up to you to
|
||||
confirm it's clean and legal to share.
|
||||
* How to get apk files: There are mobile apps you can use to get access to
|
||||
apk files on an Android phone. Alternatively, you can download app files
|
||||
directly from the developer's website.
|
||||
|
||||
### Go Further: Butter Box Supports Sharing Via F-Droid
|
||||
|
||||
Additionally, Butter Box supports app distribution via F-Droid. In your
|
||||
content pack, you can include the F-Droid `.apk` and a QR code for your
|
||||
repo. Anyone with access to the Box can then download the F-Droid app while
|
||||
offline, and add the repo.
|
||||
|
||||
As long as they are connected to the Butter Box, they can download any of
|
||||
the apps within your repo.
|
||||
|
||||
If they are connected to the internet later, they can receive app updates
|
||||
from any apps in your repo that are also included in the official F-Droid
|
||||
repo. If you update the apps in your repo, they will also have access to
|
||||
those.
|
||||
|
||||
What is a F-Ddroid Repo?
|
||||
|
||||
* A hosted library of apps\ Why use it?
|
||||
* It offers a secure process for sharing apps. The F-Droid team builds apps
|
||||
in the official F-Droid repo from the source code themselves. This ensures
|
||||
that the app you download exactly matches the code the developer
|
||||
published.
|
||||
* Users installing from F-Droid have access to app updates remotely (away
|
||||
from the Butter Box)
|
||||
|
||||
Technical skills are required to create your own F-Droid repo. Refer to the
|
||||
[F-Droid Repo](f-droid-repo) Section for instructions.
|
||||
|
|
@ -1,74 +1,50 @@
|
|||
---
|
||||
description: 'Curated pluggable content'
|
||||
sidebar_position: 1
|
||||
title: "Наборы контента"
|
||||
nav_order: 5
|
||||
has_children: true
|
||||
permalink: /content-packs/
|
||||
---
|
||||
|
||||
# Наборы контента
|
||||
|
||||
Вы можете создать свой собственный набор контента! Его просто нужно оформить
|
||||
как **статический сайт с локальными ссылками**. Этот сайт будет работать
|
||||
непосредственно с устройства, поэтому все изображения и файлы, необходимые
|
||||
для сайта, должны находиться в одной главной папке.
|
||||
Вы можете создать свой собственный набор контента! Его просто нужно оформить как **статический сайт с локальными ссылками**. Этот сайт будет работать непосредственно с устройства, поэтому все изображения и файлы, необходимые для сайта, должны находиться в одной главной папке.
|
||||
|
||||
Когда ваш статический сайт будет готов, поместите все необходимые файлы в
|
||||
одну папку и разместите эту папку в **корневой директории** вашего
|
||||
USB-накопителя. Этот сайт будет отображаться в браузере, через который
|
||||
пользователи получают доступ к порталу Butter Box.
|
||||
Когда ваш статический сайт будет готов, поместите все необходимые файлы в одну папку и разместите эту папку в **корневой директории** вашего USB-накопителя. Этот сайт будет отображаться в браузере, через который пользователи получают доступ к порталу Butter Box.
|
||||
|
||||
Советы по созданию набора контента со статическим сайтом:
|
||||
|
||||
* **Содержимое.** Всё для статического сайта должно храниться на
|
||||
USB-накопителе, подключённом к Butter Box. Сайт не должен ссылаться на
|
||||
ресурсы в глобальном интернете.
|
||||
* **Размер.** Размер вашего набора контента ограничен доступным
|
||||
пространством на USB-накопителе. При этом учитывайте, что если несколько
|
||||
человек одновременно скачивают или просматривают очень большие файлы с
|
||||
устройства, возможны задержки.
|
||||
* **Страницы.** Ссылки между страницами должны вести на другие сохранённые
|
||||
страницы в той же папке, а не в интернет. Необходимо использовать
|
||||
относительные пути (например, about/index.html) вместо абсолютных веб-URL.
|
||||
* **Медиа.** Изображения, видео и звуки не могут ссылаться на
|
||||
онлайн-ресурсы. Файлы должны находиться в папке вашего сайта и храниться
|
||||
на USB-накопителе.
|
||||
* **Библиотеки.** Сайт не может использовать JavaScript-библиотеки, которые
|
||||
зависят от интернет-соединения.
|
||||
* **Стили.** Специальные шрифты и иконки (например, из Google Fonts) также
|
||||
должны находиться в папке, а не загружаться из сети.
|
||||
* **Содержимое.** Всё для статического сайта должно храниться на USB-накопителе, подключённом к Butter Box. Сайт не должен ссылаться на ресурсы в глобальном интернете.
|
||||
* **Размер.** Размер вашего набора контента ограничен доступным пространством на USB-накопителе. При этом учитывайте, что если несколько человек одновременно скачивают или просматривают очень большие файлы с устройства, возможны задержки.
|
||||
* **Страницы.** Ссылки между страницами должны вести на другие сохранённые страницы в той же папке, а не в интернет. Необходимо использовать относительные пути (например, about/index.html) вместо абсолютных веб-URL.
|
||||
* **Медиа.** Изображения, видео и звуки не могут ссылаться на онлайн-ресурсы. Файлы должны находиться в папке вашего сайта и храниться на USB-накопителе.
|
||||
* **Библиотеки.** Сайт не может использовать JavaScript-библиотеки, которые зависят от интернет-соединения.
|
||||
* **Стили.** Специальные шрифты и иконки (например, из Google Fonts) также должны находиться в папке, а не загружаться из сети.
|
||||
|
||||
### Попробуйте
|
||||
|
||||
* The zip file below contains a sample static website. To get a feel for how
|
||||
static websites work with butter—Download it. Unzip it. Then, add this set
|
||||
of files to your USB drive.
|
||||
* Приведённый ниже zip-файл содержит пример статического сайта. Чтобы понять, как статические сайты работают с Butter — скачайте его. Распакуйте. Затем добавьте этот набор файлов на ваш USB-накопитель.
|
||||
|
||||
[Скачать файл](/img/docs/Sample%20Static%20Website.zip)
|
||||
|
||||
You can also check out our [New Content Pack News](/docs/content-packs).
|
||||
|
||||
|
||||
### Начните работу
|
||||
|
||||
Лучший способ начать создание собственного набора контента — это
|
||||
определиться с идеей о том, какой опыт и какую информацию вы хотите
|
||||
предоставить, а затем спроектировать и создать для этого локальный
|
||||
статический сайт.
|
||||
|
||||
Это может быть что-то очень простое, например, аудиоплеер для музыки. Или
|
||||
список из пяти лучших VPN-приложений, которые вы рекомендуете. Или например
|
||||
библиотека, база знаний культурных артефактов.
|
||||
|
||||
Лучший способ начать создание собственного набора контента — это определиться с идеей о том, какой опыт и какую информацию вы хотите предоставить, а затем спроектировать и создать для этого локальный статический сайт.
|
||||
|
||||
Это может быть что-то очень простое, например, аудиоплеер для музыки. Или список из пяти лучших VPN-приложений, которые вы рекомендуете. Или например библиотека, база знаний культурных артефактов.
|
||||
|
||||
### Добавьте файлы сайта на USB-накопитель
|
||||
|
||||
Поместите папку с файлами сайта в **корневую директорию**
|
||||
USB-накопителя. Убедитесь, что папка вашего сайта содержит файл
|
||||
**index.html.** Название этой папки будет отображаться на портале Butter
|
||||
Box.
|
||||
Поместите папку с файлами сайта в **корневую директорию** USB-накопителя. Убедитесь, что папка вашего сайта содержит файл **index.html.** Название этой папки будет отображаться на портале Butter Box.
|
||||
|
||||
<figure><img src="/assets/images/Screenshot 2025-08-16 at 9.46.16 PM.png" alt=""/><figcaption><p>Директория USB при просмотре в Finder на компьютере</p></figcaption></figure>
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Подключитесь к Butter Box для просмотра
|
||||
|
||||
Вставьте USB-накопитель в Butter Box. Когда вы откроете портал Butter Box,
|
||||
нажмите **Файлы**. Перейдите в папку сайта. Нажмите для просмотра.
|
||||
Вставьте USB-накопитель в Butter Box. Когда вы откроете портал Butter Box, нажмите **Файлы**. Перейдите в папку сайта. Нажмите для просмотра.
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,41 +1,38 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
title: "Карты"
|
||||
nav_order: 1
|
||||
parent: "Наборы контента"
|
||||
---
|
||||
# Maps
|
||||
|
||||
You can make offline maps available from your Butter Box. These maps are
|
||||
powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android.
|
||||
# Карты
|
||||
|
||||
:::warning
|
||||
**Important:** Offline map downloads work **only on Android devices**. iOS is not supported.
|
||||
:::
|
||||
Вы можете сделать офлайн-карты доступными через ваш Butter Box. Эти карты работают на основе **OpenStreetMap (OSM)** и приложения **OsmAnd** для Android.
|
||||
|
||||
### ✅ Steps to Enable Maps
|
||||
> **Внимание:**
|
||||
> **Важно:** Загрузка офлайн-карт работает **только на устройствах Android**. iOS не поддерживается.
|
||||
|
||||
**1. Download the map files you need**
|
||||
### ✅ Шаги для включения офлайн-карт
|
||||
|
||||
* Visit: [OsmAnd Local Indexes
|
||||
List](https://osmand.net/list?sortby=size\&asc=false)
|
||||
* Choose and download the regions you want available offline.
|
||||
**1. Скачайте приложение OsmAnd (APK для Android)**
|
||||
|
||||
**2. Organize your files**
|
||||
* Перейдите по ссылке: [Бесплатные версии OsmAnd — Android](https://osmand.net/docs/versions/free-versions)
|
||||
* Скачайте последний APK-файл.
|
||||
|
||||
* On your USB drive, create a folder named `osm-map-files` .
|
||||
* Put the **OsmAnd APK** and all your **map files** into this folder.
|
||||
**2. Скачайте нужные файлы карт**
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.44.40 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
* Перейдите по ссылке: [Список локальных индексов OsmAnd](https://osmand.net/list?sortby=size\&asc=false)
|
||||
* Выберите и скачайте регионы, которые хотите использовать офлайн.
|
||||
|
||||
**3. Add to your Butter Box**
|
||||
**3. Организуйте файлы**
|
||||
|
||||
* Insert the USB drive into your Butter Box.
|
||||
* The **Offline Maps** tile will automatically appear in your Butter Box
|
||||
portal.
|
||||
* На USB-накопителе создайте папку с именем `osm-map-files` .
|
||||
* Поместите **APK-файл OsmAnd** и все ваши **файлы карт** в эту папку.
|
||||
|
||||
👉 That’s it — anyone using an **Android device** can now download OsmAnd and
|
||||
the offline maps you’ve provided directly from your Butter Box.
|
||||
|
||||
|
||||
Note: The OSM map apk is available on the Butter Box software image. Updates
|
||||
to the OsmAnd app will be available with new releases of the Butter Box
|
||||
software. If you want to know what the latest available version of OsmAnd
|
||||
app is, visit [OsmAnd Free Releases —
|
||||
Android](https://osmand.net/docs/versions/free-versions).
|
||||
**4. Добавьте на Butter Box**
|
||||
|
||||
* Вставьте USB-накопитель в Butter Box.
|
||||
* Иконка **Офлайн-карты** автоматически появится на портале Butter Box.
|
||||
|
||||
👉 Вот и всё — теперь любой пользователь с **устройством Android** может скачать OsmAnd и офлайн-карты, которые вы предоставили, прямо с вашего Butter Box.
|
||||
|
|
|
|||
|
|
@ -1,70 +1,57 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
title: "Как переформатировать USB-накопитель"
|
||||
nav_order: 1
|
||||
parent: "Часто задаваемые вопросы"
|
||||
---
|
||||
|
||||
# Как переформатировать USB-накопитель
|
||||
|
||||
After connecting your USB drive to the Raspberry Pi you will see the
|
||||
“Explore USB” title displayed on the portal. If you’ve tried refreshing your
|
||||
portal page and still do not see the “Explore USB” tile then you may need to
|
||||
erase your USB stick and reformat it.
|
||||
После подключения USB-накопителя к Raspberry Pi вы увидите заголовок «Обзор USB» на портале. Если вы обновили страницу портала и по-прежнему не видите иконку «Обзор USB», возможно, вам нужно стереть данные с USB-накопителя и переформатировать его.
|
||||
|
||||
<br/>
|
||||
|
||||
|
||||
|
||||
|
||||
Когда вы форматируете USB-накопитель, все файлы и папки на нём удаляются и заменяются новой файловой системой. Это может помочь устранить проблемы с самим накопителем или сделать его совместимым с новыми файлами, которые вы хотите перенести. Обязательно сделайте резервную копию файлов перед форматированием накопителя.
|
||||
Когда вы форматируете USB-накопитель, все файлы и папки на нём удаляются и заменяются новой файловой системой. Это может помочь устранить проблемы с самим накопителем или сделать его совместимым с новыми файлами, которые вы хотите перенести. Обязательно сделайте резервную копию файлов перед форматированием накопителя.
|
||||
|
||||
**Проверьте формат USB-накопителя**
|
||||
|
||||
* На настольном компьютере или ноутбуке подключите USB-накопитель
|
||||
* Нажмите правой кнопкой мыши или дважды щёлкните по USB-накопителю
|
||||
* Click on “Get info” and verify the Format
|
||||
* Ваш USB-накопитель должен быть отформатирован в ExFat, Fat32 или MS-DOS
|
||||
(FAT).
|
||||
|
||||
* Нажмите «Свойства» и проверьте формат
|
||||
* Ваш USB-накопитель должен быть отформатирован в ExFat, Fat32 или MS-DOS (FAT).
|
||||
|
||||
|
||||
**Шаги переформатирования на MacOS:**
|
||||
|
||||
* Подключите USB-накопитель к USB-порту компьютера.
|
||||
* Нажмите правой кнопкой мыши или дважды щёлкните по USB-накопителю
|
||||
* Click on “Erase Disk…”
|
||||
* Нажмите «Стереть диск…»
|
||||
* На этом этапе вы можете переименовать USB-накопитель
|
||||
* Выберите правильный формат: ExFat, ExFat32 или MS-DOS (FAT)
|
||||
* Then tap “Erase”
|
||||
* A message may appear warning you that all content will be deleted. Select
|
||||
“Erase”
|
||||
* Это может занять несколько минут. USB-накопитель исчезнет и снова появится
|
||||
на рабочем столе
|
||||
* Затем нажмите «Стереть»
|
||||
* Может появиться предупреждение о том, что весь контент будет удалён. Нажмите «Стереть»
|
||||
* Это может занять несколько минут. USB-накопитель исчезнет и снова появится на рабочем столе
|
||||
* Убедитесь, что накопитель правильно отформатирован
|
||||
* Нажмите правой кнопкой мыши или дважды щёлкните по USB-накопителю
|
||||
* Click on “Get info” and verify the Format<br/>
|
||||
* Нажмите «Свойства» и проверьте формат
|
||||
|
||||
**Шаги переформатирования на Windows:**
|
||||
|
||||
* Подключите USB-накопитель к USB-порту компьютера.
|
||||
* Откройте Проводник и выберите «Этот компьютер» в меню.
|
||||
* Вы найдёте этот пункт на левой панели, рядом со значком
|
||||
монитора.[\[2\]](https://www.wikihow.com/Format-a-Flash-Drive#_note-2)
|
||||
* Вы найдёте этот пункт на левой панели, рядом со значком монитора.[\[2\]](https://www.wikihow.com/Format-a-Flash-Drive#_note-2)
|
||||
* В Windows 7 нажмите «Компьютер» в правой части окна «Пуск».
|
||||
* Нажмите правой кнопкой мыши на значок флеш-накопителя. Он находится под
|
||||
заголовком «Устройства и диски» в середине страницы. Появится выпадающее
|
||||
меню.
|
||||
* Нажмите правой кнопкой мыши на значок флеш-накопителя. Он находится под заголовком «Устройства и диски» в середине страницы. Появится выпадающее меню.
|
||||
* Выберите «Форматировать». Откроется окно форматирования.
|
||||
* Нажмите на «Файловая система» и выберите формат MS-DOS, FAT32 или exFAT.
|
||||
* [FAT32](https://www.wikihow.com/Format-FAT32) — наиболее совместимый
|
||||
формат. Работает с большинством компьютеров и игровых консолей.
|
||||
* exFAT — похож на FAT32, но разработан для внешних жёстких дисков
|
||||
(например, флеш-накопителей) и более быстрого использования. Это
|
||||
универсальный формат, наиболее распространённый в Windows, Linux и Mac.
|
||||
* [FAT32](https://www.wikihow.com/Format-FAT32) — наиболее совместимый формат. Работает с большинством компьютеров и игровых консолей.
|
||||
* exFAT — похож на FAT32, но разработан для внешних жёстких дисков (например, флеш-накопителей) и более быстрого использования. Это универсальный формат, наиболее распространённый в Windows, Linux и Mac.
|
||||
* Нажмите «Начать» и «ОК» для завершения форматирования флеш-накопителя.
|
||||
* A final prompt will appear, Click “OK”. Your flash drive has successfully
|
||||
been formatted.<br/>
|
||||
* Появится последний запрос, нажмите «ОК». Ваш флеш-накопитель успешно отформатирован.
|
||||
|
||||
|
||||
.png>).png>).png>)
|
||||
|
||||
|
||||
.png>)
|
||||
|
||||
|
||||
.png>)
|
||||
|
||||
<br/>
|
||||
|
|
|
|||
|
|
@ -1,78 +1,58 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
title: "Часто задаваемые вопросы"
|
||||
nav_order: 8
|
||||
has_children: true
|
||||
permalink: /faq/
|
||||
---
|
||||
|
||||
# Часто задаваемые вопросы
|
||||
|
||||
### Предоставляет ли Butter Box доступ к интернету?
|
||||
|
||||
Not quite. The Butter Box doesn’t provide internet access. Instead, it
|
||||
creates its own local Wi-Fi network that lets you access apps, content
|
||||
(previously set up), and message board features offline . Everything is
|
||||
stored and shared locally — no internet or data connection needed.
|
||||
Не совсем. Butter Box не обеспечивает доступ к интернету. Вместо этого он создаёт собственную локальную сеть Wi-Fi, которая позволяет получить доступ к приложениям, контенту (предварительно загруженному) и функциям доски сообщений в офлайн-режиме. Всё хранится и передаётся локально — подключение к интернету или передача данных не требуется.
|
||||
|
||||
***
|
||||
|
||||
### Как запитать Butter Box?
|
||||
|
||||
The Butter Box is super flexible! You can power it using a USB power bank, a
|
||||
wall adapter, or even a small solar panel. As long as it provides power to
|
||||
the Raspberry Pi, you’re good to go. Go to the [Power
|
||||
Supply](../build-a-box/power-supply) section to learn more.
|
||||
Butter Box очень гибок в плане питания! Вы можете подключить его к USB-повербанку, сетевому адаптеру или даже к небольшой солнечной панели. Главное, чтобы источник обеспечивал питание Raspberry Pi. Перейдите в раздел [Блок питания](../build-a-box/power-supply.mdx), чтобы узнать больше.
|
||||
|
||||
***
|
||||
|
||||
### If I’m powering the Butter Box with a solar panel, do I need a power bank?
|
||||
### Если я подключаю Butter Box к солнечной панели, нужен ли мне повербанк?
|
||||
|
||||
A power bank isn’t strictly required, but it’s highly recommended. Solar
|
||||
panels can be inconsistent — clouds, shade, or changing sunlight can
|
||||
interrupt power. A power bank helps smooth that out by storing energy and
|
||||
keeping the Butter Box running steadily, even when sunlight dips. Check it
|
||||
out this use case to know more: (insert use case URL)
|
||||
Повербанк не обязателен, но настоятельно рекомендуется. Солнечные панели могут работать нестабильно — облака, тень или изменение освещённости могут прервать питание. Повербанк помогает сгладить это, накапливая энергию и обеспечивая стабильную работу Butter Box, даже когда солнечный свет ослабевает. Ознакомьтесь с этим примером использования, чтобы узнать больше: (вставьте URL примера использования)
|
||||
|
||||
***
|
||||
|
||||
### Какие функции безопасности есть у Butter Box? Можно ли установить на него пароль?
|
||||
|
||||
Currently, the Butter Box broadcasts an open Wi-Fi network — that means no
|
||||
password is required to connect. This makes it easy for people nearby to
|
||||
join, especially in offline or community settings.
|
||||
В настоящее время Butter Box транслирует открытую сеть Wi-Fi — это означает, что для подключения пароль не требуется. Это упрощает подключение для находящихся рядом людей, особенно в оффлайн-средах или в условиях сообщества.
|
||||
|
||||
However, users must either enter the Butter Box’s local IP address manually,
|
||||
or scan a QR code that takes them directly to the content. Since it’s all
|
||||
offline, there’s no exposure to the internet or external threats.
|
||||
Однако пользователи должны либо ввести локальный IP-адрес или адрес Butter Box вручную, либо отсканировать QR-код для доступа к контенту. Поскольку всё работает оффлайн, нет риска воздействия интернета или внешних угроз.
|
||||
|
||||
Вы можете настроить Wi-Fi Raspberry Pi на требование пароля в настройках
|
||||
администратора. Обратитесь к разделу [Безопасность](../security.mdx) для
|
||||
получения информации о дополнительных функциях безопасности.
|
||||
Вы можете настроить Wi-Fi Raspberry Pi на требование пароля в настройках администратора. Обратитесь к разделу [Безопасность](../security.mdx) для получения информации о дополнительных функциях безопасности.
|
||||
|
||||
***
|
||||
|
||||
### Какой объём хранилища у Butter Box?
|
||||
|
||||
The Butter Box storage capacity is defined by the microSD card you install —
|
||||
it doesn’t have fixed built-in memory. You can choose anything from a 16 GB
|
||||
card up to 1 TB (the Raspberry Pi Zero 2 W supports microSD sizes up to
|
||||
that). We recommend 256 GB.
|
||||
Объём хранилища Butter Box определяется установленной картой microSD — у него нет фиксированной встроенной памяти. Вы можете выбрать карту от 16 ГБ до 1 ТБ (Raspberry Pi Zero 2 W поддерживает карты microSD такого размера). Мы рекомендуем 256 ГБ.
|
||||
|
||||
| Use Case | Suggested micro SD Size |
|
||||
| ------------------------------------- | -------------------------- |
|
||||
| Basic setup (apps + message board) | 16 GB – 32 GB |
|
||||
| Additional content or media storage | 64 GB – 128 GB |
|
||||
| Handling large content packs or files | 256 GB or more, up to 1 TB |
|
||||
| Сценарий использования | Рекомендуемый размер micro SD |
|
||||
| ------------------------------------------- | ----------------------------- |
|
||||
| Базовая настройка (приложения + доска сообщений) | 16 ГБ – 32 ГБ |
|
||||
| Дополнительный контент или хранение медиа | 64 ГБ – 128 ГБ |
|
||||
| Работа с большими контент-пакетами или файлами | 256 ГБ и более, до 1 ТБ |
|
||||
|
||||
***
|
||||
|
||||
### Можно ли его настроить?
|
||||
|
||||
Absolutely! You can add, for example, your own content - dropping in PDFs,
|
||||
videos, images, and HTML pages to build a local library, or add your own
|
||||
apps - including Android APKs (even if they’re not on F-Droid).
|
||||
Безусловно! Вы можете добавить, например, свой собственный контент — поместить PDF-файлы, видео, изображения и HTML-страницы для создания локальной библиотеки, или добавить свои приложения — включая APK-файлы для Android (даже если их нет на F-Droid).
|
||||
|
||||
***
|
||||
|
||||
### Мой USB-накопитель подключён к Butter Box, но контент не отображается на портале. Почему?
|
||||
|
||||
Вероятно, ваш USB-накопитель имеет неправильный формат. USB-накопитель
|
||||
должен быть отформатирован в ExFat, Fat32, MS-DOS (FAT). Обратитесь к
|
||||
разделу [Переформатирование
|
||||
USB-накопителя](how-to-reformat-your-usb-drive.mdx) для помощи.
|
||||
Вероятно, ваш USB-накопитель имеет неправильный формат. USB-накопитель должен быть отформатирован в ExFat, Fat32, MS-DOS (FAT). Обратитесь к разделу [Переформатирование USB-накопителя](how-to-reformat-your-usb-drive.mdx) для помощи.
|
||||
|
|
|
|||
|
|
@ -1,17 +1,15 @@
|
|||
---
|
||||
description: 'Начало работы'
|
||||
sidebar_position: 1
|
||||
title: "Начало работы"
|
||||
nav_order: 1
|
||||
---
|
||||
|
||||
# Начните работу
|
||||
# Начало работы
|
||||
|
||||
Butter Box is a lightweight, portable device that functions like a hard
|
||||
drive with its own hotspot. Anyone nearby can connect to it and view or
|
||||
download its contents—no internet required.
|
||||
Butter Box — это лёгкое портативное устройство, которое работает как жёсткий диск с собственной точкой доступа. Любой, кто находится рядом, может подключиться к нему и просматривать или скачивать его содержимое — без интернета.
|
||||
|
||||
Неважно, есть ли у вас Butter Box на руках или вам нужно его собрать, вы в
|
||||
нужном месте. Выберите вариант ниже.
|
||||
Неважно, есть ли у вас Butter Box на руках или вам нужно его собрать, вы в нужном месте. Выберите вариант ниже.
|
||||
|
||||
## [**У меня есть Box** — Быстрый старт](quick-start.mdx) ...or... [**Мне нужен Box** — Собрать Box](build-a-box/)
|
||||
- [**У меня есть Box** — Быстрый старт](quick-start.mdx)
|
||||
- [**Мне нужен Box** — Собрать Box](build-a-box/)
|
||||
|
||||
|
||||
|
|
|
|||
|
|
@ -1,10 +1,12 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
title: "Быстрый старт"
|
||||
nav_order: 2
|
||||
---
|
||||
|
||||
# Быстрый старт
|
||||
|
||||
Если у вас есть Butter Box с последней версией программного обеспечения
|
||||
Butter, загруженной на SD-карту, выполните эти быстрые шаги для настройки.
|
||||
Если у вас есть Butter Box с последней версией программного обеспечения Butter, загруженной на SD-карту, выполните эти быстрые шаги для настройки.
|
||||
|
||||
|
||||
### Проверьте комплектующие
|
||||
|
||||
|
|
@ -16,74 +18,71 @@ Butter, загруженной на SD-карту, выполните эти б
|
|||
* [ ] Устройство Butter Box (с вставленной micro SD-картой)
|
||||
* [ ] Корпус
|
||||
|
||||
<figure><img src="/img/docs/signal-2025-08-21-140334_003.jpeg" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Убедитесь, что micro SD-карта вставлена в устройство
|
||||
|
||||
На micro SD-карте должна быть записана последняя версия Butter OS.
|
||||
|
||||
---
|
||||
|
||||
### Подключите к питанию для включения
|
||||
|
||||
Подключите блок питания к первому порту micro USB и к розетке.
|
||||
|
||||
<figure><img src="/img/docs/1.png" alt="" width="375"/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
You will know the box is working if ‘butterbox’ wifi appears in the wifi
|
||||
list on your phone or computer. If it doesn’t, unplug the box and plug it
|
||||
back in.
|
||||
Вы узнаете, что Box работает, если Wi-Fi 'butterbox' появится в списке Wi-Fi на вашем телефоне или компьютере. Если он не появляется, отключите Box и подключите его снова.
|
||||
|
||||
|
||||
|
||||
_Если вы используете солнечную батарею или другой источник питания,
|
||||
используйте устройство с правильными характеристиками, чтобы обеспечить
|
||||
достаточную мощность и избежать повреждения устройства. Для Pi Zero 2 W
|
||||
используйте блок питания Micro USB мощностью не менее 2.0A._
|
||||
_Если вы используете солнечную батарею или другой источник питания, используйте устройство с правильными характеристиками, чтобы обеспечить достаточную мощность и избежать повреждения устройства. Для Pi Zero 2 W используйте блок питания Micro USB мощностью не менее 2.0A._
|
||||
|
||||
[Ссылка на варианты блоков питания](build-a-box/power-supply.mdx)
|
||||
|
||||
|
||||
---
|
||||
|
||||
|
||||
### Вставьте USB-накопитель
|
||||
|
||||
Подключите USB-адаптер к свободному порту. Затем подключите
|
||||
USB-накопитель. Узнайте больше о загрузке контента на USB-накопитель в
|
||||
разделе [Обмен файлами](services/file-sharing.mdx).
|
||||
Подключите USB-адаптер к свободному порту. Затем подключите USB-накопитель. Узнайте больше о загрузке контента на USB-накопитель в разделе [Обмен файлами](services/file-sharing.mdx).
|
||||
|
||||
|
||||
|
||||
---
|
||||
|
||||
<figure><img src="/img/docs/2.png" alt="" width="375"/><figcaption></figcaption></figure>
|
||||
|
||||
### Доступ к порталу Butter Box
|
||||
|
||||
Join the ‘butterbox’ Wi-Fi. After 30 seconds, scan the QR code on the
|
||||
box. This connects you to **http://butterbox.local** in a browser.
|
||||
Подключитесь к Wi-Fi 'butterbox'. Через 30 секунд отсканируйте QR-код на Box. Это подключит вас к **http://butterbox.local** в браузере.
|
||||
|
||||
[https://youtu.be/KB5O9MSoaAg](https://youtu.be/KB5O9MSoaAg)
|
||||
|
||||
<div align="center"><figure><img src="/img/docs/qr code.png" alt="" width="375"/><figcaption></figcaption></figure></div>
|
||||
|
||||
_If this page does not load, wait a few minutes to ensure
|
||||
connectivity. Refresh the page. If you’re connecting from a smartphone, turn
|
||||
off your mobile data or turn on airplane mode. Then try again._
|
||||
_Если эта страница не загружается, подождите несколько минут для установления соединения. Обновите страницу. Если вы подключаетесь со смартфона, отключите мобильные данные или включите режим полёта. Затем попробуйте снова._
|
||||
|
||||
:::info
|
||||
Это HTTP-страница, а не HTTPS, потому что она обслуживается локальным устройством без подключения к интернету. Ваши данные никогда не покидают сеть, поэтому они по-прежнему конфиденциальны и безопасны.
|
||||
:::
|
||||
> **Информация:**
|
||||
> Это HTTP-страница, а не HTTPS, потому что она обслуживается локальным устройством без подключения к интернету. Ваши данные никогда не покидают сеть, поэтому они по-прежнему конфиденциальны и безопасны.
|
||||
|
||||
Wi-Fi по умолчанию не имеет пароля. Однако вы можете легко добавить его в
|
||||
настройках администратора.
|
||||
Wi-Fi по умолчанию не имеет пароля. Однако вы можете легко добавить его в настройках администратора.
|
||||
|
||||
---
|
||||
|
||||
### После подключения используйте «настройки администратора» для настройки вашего Butter Box.
|
||||
|
||||
Мастер настройки администратора предназначен для того, чтобы предоставить
|
||||
вам выбор, какие сервисы предлагаются на Butter Box, и чтобы повысить его
|
||||
безопасность. Вам будет предложено перейти в «настройки администратора»,
|
||||
если вы используете Box впервые.
|
||||
Мастер настройки администратора предназначен для того, чтобы предоставить вам выбор, какие сервисы предлагаются на Butter Box, и чтобы повысить его безопасность. Вам будет предложено перейти в «настройки администратора», если вы используете Box впервые.
|
||||
|
||||
---
|
||||
|
||||
### Поделитесь доступом к порталу
|
||||
|
||||
Когда вы поделитесь доступом с другими, они подключатся к нему так же, как
|
||||
это сделали вы.
|
||||
Когда вы поделитесь доступом с другими, они подключатся к нему так же, как это сделали вы.
|
||||
|
||||
:::info
|
||||
Для Pi Zero 2 W: к Box одновременно могут подключиться до 5 человек. После того как люди подключатся и получат то, что им нужно, попросите их отключиться, чтобы дать возможность другим.\
|
||||
Физическая зона действия Box варьируется. Но как правило, люди, находящиеся в одном помещении с Box (или на расстоянии слышимости), смогут получить к нему доступ.
|
||||
:::
|
||||
---
|
||||
|
||||
> **Информация:**
|
||||
> Для Pi Zero 2 W: к Box одновременно могут подключиться до 5 человек. После того как люди подключатся и получат то, что им нужно, попросите их отключиться, чтобы дать возможность другим.\
|
||||
> Физическая зона действия Box варьируется. Но как правило, люди, находящиеся в одном помещении с Box (или на расстоянии слышимости), смогут получить к нему доступ.
|
||||
|
|
|
|||
|
|
@ -1,49 +1,32 @@
|
|||
---
|
||||
description: Безопасность
|
||||
sidebar_position: 7
|
||||
title: "Безопасность"
|
||||
nav_order: 7
|
||||
---
|
||||
|
||||
# Безопасность
|
||||
|
||||
Это руководство было разработано для развёртывания в опасных средах, где
|
||||
устройства могут быть досмотрены, конфискованы, модифицированы или
|
||||
использованы не по назначению. Оно направлено на предоставление практических
|
||||
рекомендаций по повышению физической и цифровой устойчивости Butter Box к
|
||||
взлому.
|
||||
Это руководство было разработано для развёртывания в опасных средах, где устройства могут быть досмотрены, конфискованы, модифицированы или использованы не по назначению. Оно направлено на предоставление практических рекомендаций по повышению физической и цифровой устойчивости Butter Box к взлому.
|
||||
|
||||
Следование рекомендациям в этом руководстве поможет снизить риски, но не
|
||||
гарантирует абсолютную безопасность. Предполагается, что Butter Box — это
|
||||
развёртываемая в полевых условиях, недорогая офлайн-система, поэтому эти
|
||||
рекомендации отдают приоритет реалистичным и доступным мерам защиты.
|
||||
Следование рекомендациям в этом руководстве поможет снизить риски, но не гарантирует абсолютную безопасность. Предполагается, что Butter Box — это развёртываемая в полевых условиях, недорогая офлайн-система, поэтому эти рекомендации отдают приоритет реалистичным и доступным мерам защиты.
|
||||
|
||||
**Допущения модели угроз**
|
||||
|
||||
Прежде чем применять меры контроля, чётко определите контекст вашего
|
||||
развёртывания. Это руководство предполагает один или несколько из следующих
|
||||
рисков:
|
||||
Прежде чем применять меры контроля, чётко определите контекст вашего развёртывания. Это руководство предполагает один или несколько из следующих рисков:
|
||||
|
||||
* Физический доступ неавторизованных пользователей
|
||||
* Конфискация или досмотр устройства властями
|
||||
* Злонамеренные действия локальных пользователей
|
||||
* Манипулирование или подмена контента
|
||||
* Злоупотребление сетью или выдача себя за другого
|
||||
* Повторное использование учётных данных или злоупотребление конфигурацией
|
||||
по умолчанию
|
||||
|
||||
Помните, что меры контроля должны адаптироваться к локальному уровню риска —
|
||||
чрезмерное укрепление защиты может снизить удобство использования и доверие.
|
||||
|
||||
* Повторное использование учётных данных или злоупотребление конфигурацией по умолчанию
|
||||
|
||||
Помните, что меры контроля должны адаптироваться к локальному уровню риска — чрезмерное укрепление защиты может снизить удобство использования и доверие.
|
||||
|
||||
### Раздел 1: Физическая устойчивость к взлому
|
||||
|
||||
#### Защита корпуса и оборудования
|
||||
|
||||
Физический доступ к Butter Box позволяет клонировать SD-карту, заменить
|
||||
прошивку, внедрить вредоносное ПО и транслировать вредоносную
|
||||
информацию. Печатные платы также хрупкие и должны иметь дополнительную
|
||||
защиту для обеспечения их сохранности при повседневном использовании и
|
||||
воздействии погодных условий.
|
||||
Физический доступ к Butter Box позволяет клонировать SD-карту, заменить прошивку, внедрить вредоносное ПО и транслировать вредоносную информацию. Печатные платы также хрупкие и должны иметь дополнительную защиту для обеспечения их сохранности при повседневном использовании и воздействии погодных условий.
|
||||
|
||||
Рекомендации:
|
||||
|
||||
|
|
@ -51,61 +34,45 @@ sidebar_position: 7
|
|||
2. Предпочтительны винты с защитой от вскрытия (Torx, защитный шестигранник)
|
||||
3. Наносите индикаторные наклейки на швы корпуса и слоты SD-карт
|
||||
|
||||
| 1) Sealed enclosures | 2) Screws |
|
||||
| 1) Герметичные корпуса | 2) Винты |
|
||||
| --------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
|  | .jpeg>) |
|
||||
|
||||
#### 
|
||||
#### 
|
||||
|
||||
#### Защита SD-карты и хранилища
|
||||
|
||||
Рекомендации:
|
||||
|
||||
1. Используйте высококачественные SD-карты для повышения надежности хранения
|
||||
данных
|
||||
1. Используйте высококачественные SD-карты для повышения надежности хранения данных
|
||||
2. Шифруйте чувствительные разделы (где это возможно)
|
||||
3. Держите контент и ОС раздельно (прошивка и наборы контента)
|
||||
4. Избегайте названий SD-карт, компрометирующих владельца
|
||||
|
||||
Дополнительно (контексты повышенного риска):
|
||||
|
||||
1. Epoxy Resin. Electronico potting solutions protect Printed Circuit
|
||||
Boards from extreme temperatures, moisture, vibration, and other
|
||||
environmental threats.
|
||||
1. Эпоксидная смола. Решения для заливки электроники защищают печатные платы от экстремальных температур, влажности, вибрации и других угроз.
|
||||
2. Физическая блокировка извлечения SD-карты
|
||||
|
||||
|
||||
|
||||
| Epoxy Resin | Epoxy Resin |
|
||||
| Эпоксидная смола | Эпоксидная смола |
|
||||
| --------------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
| .jpeg>) | .jpeg>) |
|
||||
|
||||
#### 
|
||||
#### .jpeg>)
|
||||
|
||||
#### Управление питанием и портами
|
||||
|
||||
Рекомендации:
|
||||
|
||||
1. Отключите или физически заблокируйте неиспользуемые порты (USB,
|
||||
HDMI). Недорогие физические блокираторы портов могут использоваться для
|
||||
снижения риска взлома Butter Box путём предотвращения
|
||||
несанкционированного доступа к открытым интерфейсам. Эти блокираторы
|
||||
ограничивают возможность злоумышленников внедрять вредоносный код,
|
||||
подключать несанкционированные периферийные устройства или транслировать
|
||||
нежелательный контент. Порты запечатываются пластиковыми блокираторами,
|
||||
которые можно снять только с помощью специального ключа, входящего в
|
||||
комплект развёртывания.
|
||||
2. Избегайте открытия Ethernet-портов, если это не требуется. Ethernet-порты
|
||||
должны оставаться отключёнными или физически заблокированными, если они
|
||||
явно не требуются для развёртывания. Когда доступ через Ethernet
|
||||
необходим, его использование должно быть чётко задокументировано и
|
||||
ограничено доверенными операторами.
|
||||
1. Отключите или физически заблокируйте неиспользуемые порты (USB, HDMI). Недорогие физические блокираторы портов могут использоваться для снижения риска взлома Butter Box путём предотвращения несанкционированного доступа к открытым интерфейсам. Эти блокираторы ограничивают возможность злоумышленников внедрять вредоносный код, подключать несанкционированные периферийные устройства или транслировать нежелательный контент. Порты запечатываются пластиковыми блокираторами, которые можно снять только с помощью специального ключа, входящего в комплект развёртывания.
|
||||
2. Избегайте открытия Ethernet-портов, если это не требуется. Ethernet-порты должны оставаться отключёнными или физически заблокированными, если они явно не требуются для развёртывания. Когда доступ через Ethernet необходим, его использование должно быть чётко задокументировано и ограничено доверенными операторами.
|
||||
3. Используйте короткие внутренние кабели для усложнения обнаружения
|
||||
4. Избегайте индентифицирующих маркировок (имена, названия организаций)
|
||||
|
||||
| USB & HDMI | Ethernet Ports |
|
||||
| USB и HDMI | Ethernet-порты |
|
||||
| --------------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
| .jpeg>) | .jpeg>) |
|
||||
|
||||
#### Эксплуатационные практики
|
||||
|
||||
|
|
@ -114,8 +81,7 @@ sidebar_position: 7
|
|||
* Храните устройства в надежном месте, когда они не используются
|
||||
* Регулярно проверяйте работоспособность и обслуживайте Butter Box
|
||||
* Предполагайте, что устройства могут быть скопированы или утеряны
|
||||
* Treat Butter Boxes as semi-disposable infrastructure, not personal
|
||||
devices.
|
||||
* Относитесь к Butter Box как к полуодноразовой инфраструктуре, а не как к персональным устройствам.
|
||||
|
||||
### Раздел 2: Цифровая устойчивость к взлому
|
||||
|
||||
|
|
@ -127,28 +93,18 @@ SSH
|
|||
|
||||
* По умолчанию пользователь pi имеет пароль butterbox-admin.
|
||||
* Измените этот пароль, подключившись к pi через ssh и выполнив passwd.
|
||||
* Если вы предпочитаете использовать SSH-ключ, обязательно отключите доступ
|
||||
по паролю после включения доступа на основе ключей.
|
||||
* Если вы предпочитаете использовать SSH-ключ, обязательно отключите доступ по паролю после включения доступа на основе ключей.
|
||||
|
||||
RaspAP
|
||||
|
||||
* Точка доступа имеет административный интерфейс, который можно использовать
|
||||
для изменения её настроек.
|
||||
* По умолчанию: пользователь: admin, пароль: secret (по иронии, это не
|
||||
секрет)
|
||||
* Change this by logging in at
|
||||
[http://butterbox.lan/admin](http://butterbox.lan/admin) (or
|
||||
[http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin)
|
||||
for a Spanish language box) and using the Web UI.
|
||||
* Точка доступа имеет административный интерфейс, который можно использовать для изменения её настроек.
|
||||
* По умолчанию: пользователь: admin, пароль: secret (по иронии, это не секрет)
|
||||
* Измените доступы, войдя на[ http://butterbox.lan/admin](http://butterbox.lan/admin) и используя веб-интерфейс.
|
||||
|
||||
Чат
|
||||
|
||||
* Локальный чат был создан административным пользователем
|
||||
butterbox-admin. Пароль для этого пользователя также butterbox-admin.
|
||||
* Измените этот пароль, войдя в Butter Box, перейдя в публичную комнату
|
||||
чата, затем посетив свой профиль пользователя и обновив пароль. По вашему
|
||||
усмотрению вы также можете изменить имя с butterbox-admin, чтобы другие
|
||||
пользователи вас узнавали.
|
||||
* Локальный чат был создан административным пользователем butterbox-admin. Пароль для этого пользователя также butterbox-admin.
|
||||
* Измените этот пароль, войдя в Butter Box, перейдя в публичную комнату чата, затем посетив свой профиль пользователя и обновив пароль. По вашему усмотрению вы также можете изменить имя с butterbox-admin, чтобы другие пользователи вас узнавали.
|
||||
|
||||
Лучшие практики:
|
||||
|
||||
|
|
@ -157,7 +113,6 @@ RaspAP
|
|||
* Никогда не используйте учётные данные повторно в разных регионах
|
||||
|
||||
#### Повышение информационной безопасности
|
||||
|
||||
Рекомендации:
|
||||
|
||||
* Отключите сервисы, которые не являются строго необходимыми:
|
||||
|
|
@ -179,7 +134,6 @@ RaspAP
|
|||
* Документируйте источники обновлений и даты
|
||||
|
||||
|
||||
|
||||
### Раздел 3: Предотвращение злоупотреблений
|
||||
|
||||
#### Злоупотребления в локальном чате и контенте
|
||||
|
|
@ -199,7 +153,6 @@ RaspAP
|
|||
* Режим только для чтения для большинства пользователей
|
||||
|
||||
|
||||
|
||||
### Раздел 4: Реагирование на инциденты и восстановление
|
||||
|
||||
Превентивные меры:
|
||||
|
|
@ -208,4 +161,4 @@ RaspAP
|
|||
* Поддерживайте простую процедуру очистки и перепрошивки
|
||||
* Отслеживайте развёртывания
|
||||
|
||||
<br/>
|
||||
|
||||
|
|
|
|||
|
|
@ -1,59 +0,0 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
# File Sharing
|
||||
|
||||
<figure><img src="/img/docs/media-type-explore.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
## Share Media, Files and Digital Books
|
||||
|
||||
You can use your Butter Box to share media, files, and digital books. To
|
||||
display additional content in your portal, connect a USB drive containing
|
||||
the information you want to share.
|
||||
|
||||
If you’d like more control over how your content is displayed, you can build
|
||||
a **static website** and share it through the Butter Box. Learn more in the
|
||||
[Content Packs](../content-packs/) section.
|
||||
|
||||
|
||||
|
||||
### Add files to your USB Drive
|
||||
|
||||
Place individual files directly in the **main directory** (root) of your USB
|
||||
drive. Or, create folders to organize your files (eg. "Books", "Music",
|
||||
"Reports)
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.50.15 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
|
||||
**Things to Know**
|
||||
|
||||
* The **folder names you use** on your USB drive will be shown in the Butter
|
||||
Box portal.
|
||||
* Organizing content into folders makes it easier for others to browse and
|
||||
download.
|
||||
|
||||
### Подключитесь к Butter Box для просмотра
|
||||
|
||||
Insert the USB drive into your Butter Box. After connecting your USB drive
|
||||
to the Raspberry Pi you will see the **Files** tile displayed when you open
|
||||
the Butter Box portal.
|
||||
|
||||
<div><figure><img src="/img/docs/Screenshot_20260414-122810.png" alt=""/><figcaption></figcaption></figure> <figure><img src="/img/docs/Screenshot_20260414-122821.png" alt=""/><figcaption></figcaption></figure></div>
|
||||
|
||||
|
||||
|
||||
**Troubleshooting**
|
||||
|
||||
If you don’t see the **Files** tile, try the following actions:
|
||||
|
||||
* Remove the USB drive from the Butter Box. Then re-insert the USB drive.
|
||||
* Turn on/off airplane mode. Reconnect Butter Box wifi.
|
||||
* Refresh the browser page.
|
||||
|
||||
If you are still having trouble you may need to [Reformat Your USB
|
||||
Drive](../faq/how-to-reformat-your-usb-drive).
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Features
|
||||
|
||||
|
|
@ -1,110 +0,0 @@
|
|||
---
|
||||
description: 'A place for anyone connected to the box to share'
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Local Chat
|
||||
|
||||
There is one local chat on your Butter Box that is open to anyone who is
|
||||
able to join the box. If they can open the portal, they can open the chat
|
||||
and say or post anything they want. Depending on your use case, moderation
|
||||
capabilities may be important.
|
||||
|
||||
First, let's look at what you can and can't do with this local chat.
|
||||
|
||||
✅ **You Can**<br/>
|
||||
|
||||
* Host videos up to 5 GB PDFs, images, record, audio messages, share
|
||||
pre-recorded audio messages or music
|
||||
* Download the full chat or any individual piece of content or media that
|
||||
people have shared
|
||||
|
||||
❌ **You Cannot**<br/>
|
||||
|
||||
* Use the chat to talk with people who are not connected to the Butter Box
|
||||
* Get notifications when there are new posts or messages
|
||||
* See the messages unless you are connected to the Butter Box
|
||||
|
||||
|
||||
|
||||
## Moderation
|
||||
|
||||
A Butter Box offers moderation features for the local chat. In order to
|
||||
access these features, you need to login as the admin of the room.
|
||||
|
||||
### Become the Admin
|
||||
|
||||
### Logout as Guest
|
||||
|
||||
When you open the local chat, you are assigned a guest identity. First
|
||||
logout of the account that was created for you.
|
||||
|
||||
### Login as Admin
|
||||
|
||||
Login to the `butterbox-admin` account. Username and password are both
|
||||
`butterbox-admin`.
|
||||
|
||||
### Change Admin Password
|
||||
|
||||
Visit your user profile to change the password. At your discretion, you may
|
||||
also wish to change your display name so that other users will recognize
|
||||
you.
|
||||
|
||||
### Moderation Features
|
||||
|
||||
Once you are an admin, you have access to the following features:
|
||||
|
||||
* **Set a message timer**
|
||||
* **Delete messages**
|
||||
* **Promote members to moderator or admin**
|
||||
* **Kick members out.**
|
||||
* Keep in mind that someone can simply rejoin as a new guest if they
|
||||
reconnect to the box
|
||||
* **Delete the room.**
|
||||
* Warning: If you delete the room, you will no longer have a local chat on
|
||||
your Butter Box. To get one back, you will have to flash a new image of
|
||||
the Butter Box software to your SD card.
|
||||
|
||||
|
||||
|
||||
## Say Even More—Direct Messages and Private Rooms
|
||||
|
||||
In addition to the local chat, you can create any number of private rooms
|
||||
from the same interface.
|
||||
|
||||
### Things To Know
|
||||
|
||||
* Each room will have it's own QR code.
|
||||
* Private rooms are not discoverable from the Butter Box portal.
|
||||
* If you create a private room, you have to share the QR code physically to
|
||||
whomever you want to join **who is also connected to the box.**
|
||||
* Every private chat that you are part of, will be easy for **you** to
|
||||
find. They will all show up in your room list.
|
||||
|
||||
### Instructions
|
||||
|
||||
You can create a private room from two different places in the message board
|
||||
interface.
|
||||
|
||||
### Open from Avatar Modal
|
||||
|
||||
Tap on your avatar in the top bar. Select **new room.**
|
||||
|
||||
| <img src="/img/docs/image.png" alt="" data-size="original"/> | |
|
||||
| -------------------------------------------------------------------- | - |
|
||||
|
||||
|
||||
|
||||
### Open from Room List
|
||||
|
||||
Your room list is accessible from your profile page. Once here, select **new
|
||||
room.**
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-01-20 at 1.42.17 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -1,17 +0,0 @@
|
|||
---
|
||||
description: 'Using Delta Chat with a Butter Box'
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Private Messenger
|
||||
|
||||
With the Private Messenger service, you can exchange secure messages with
|
||||
people you know. [Delta Chat](https://delta.chat/) is a messaging app that
|
||||
uses email protocols to exchange messages. When used through a Butter Box,
|
||||
people who create accounts on the same Butter Box can send messages to each
|
||||
other without the internet.
|
||||
|
||||
Think of the Butter Box like a local post office. Whenever you connect to
|
||||
the Box’s network, your Delta Chat app can send outgoing messages and sync
|
||||
to receive any new ones waiting for you.
|
||||
|
||||
|
|
@ -1,26 +1,17 @@
|
|||
---
|
||||
sidebar_position: 6
|
||||
title: "Обновление Butter"
|
||||
nav_order: 6
|
||||
---
|
||||
|
||||
# Обновление Butter
|
||||
|
||||
### Ознакомьтесь с новыми релизами от команды Butter Box
|
||||
|
||||
[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
|
||||
Всегда выбирайте последнюю версию файла
|
||||
:::
|
||||
|
||||
### Early Access Development Releases
|
||||
|
||||
WARNING: These are early releases posted for development testing and MUST
|
||||
NOT be used in production deployments.
|
||||
|
||||
[Download Early Access Development
|
||||
Images](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list)
|
||||
> **Информация:**
|
||||
> Всегда выбирайте последнюю версию файла
|
||||
|
||||
### Обновите ваш Butter Box
|
||||
|
||||
Обновите ваш Butter Box, используя то же руководство, которому вы следуете
|
||||
при первоначальной настройке Butter Box. Вы можете найти его здесь:
|
||||
[Установка на Raspberry Pi](build-a-box/raspberry-pi/install-butter.mdx)
|
||||
Обновите ваш Butter Box, используя то же руководство, которому вы следуете при первоначальной настройке Butter Box. Вы можете найти его здесь: [Установка на Raspberry Pi](build-a-box/raspberry-pi/install-butter.mdx)
|
||||
|
|
|
|||
|
|
@ -1,23 +0,0 @@
|
|||
---
|
||||
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.
|
||||
|
||||
|
|
@ -1,69 +0,0 @@
|
|||
---
|
||||
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!)
|
||||
|
||||
|
||||
|
|
@ -1,25 +0,0 @@
|
|||
---
|
||||
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>
|
||||
|
|
@ -1,49 +0,0 @@
|
|||
---
|
||||
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>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -1,69 +0,0 @@
|
|||
---
|
||||
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.
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Raspberry Pi
|
||||
|
||||
|
|
@ -1,103 +0,0 @@
|
|||
---
|
||||
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>
|
||||
|
|
@ -1,24 +0,0 @@
|
|||
---
|
||||
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>
|
||||
|
|
@ -1,18 +0,0 @@
|
|||
---
|
||||
sidebar_position: 9
|
||||
---
|
||||
# Use Cases
|
||||
|
||||
### 1. Digital Security training to distribute apps and materials
|
||||
|
||||
> Leaders from Southern Africa countries travel to provide training, audits, and consultations to organizations about digital security, physical safety, risk assessments, and to equip journalists, activists and human rights defenders with the tools and knowledge to do their job safer. In order to do their work effectively, these leaders need to be able to curate specific types of content to fit various use cases, in different contexts and languages and different formats. In offline situations (load shedding, no access to the internet or in times of internet shutdowns) the ability to successfully deliver trainings and content becomes almost impossible. \
|
||||
> \
|
||||
> They shared more than a few times that if they did not have the Butter Box, some sessions would have been canceled.
|
||||
|
||||
### 2. Sharing & Media Backup
|
||||
|
||||
> Often M. wants to share music and movie files that they’ve downloaded on their computer with their friends — but transferring with cables or Bluetooth is a pain. So they've set up a Butter Box with their media collection — music files, films and photos. They plugged it in near the kitchen, and now anyone in their apartment can connect to the Butter Wi‑Fi and browse a shared media library. No internet needed, and no more file-by-file transfers.
|
||||
|
||||
### 3. Temporary file storage
|
||||
|
||||
> On a remote site with no cell service, workers needed a way to temporarily offload large files — like site photos or documents — from their phones. Using Butter Box’s local encrypted message board, they sent files to themselves or coworkers for safekeeping. Files stayed on the device until retrieved later, even without power or signal.
|
||||
|
|
@ -1,160 +0,0 @@
|
|||
---
|
||||
description: 'How to Create Your Own F-Droid Repo to Share as a Content Pack'
|
||||
sidebar_position: 2
|
||||
---
|
||||
|
||||
# F-Droid Repo
|
||||
|
||||
You can build your own curated F-Droid repo using your computer's
|
||||
terminal. Once set up, users can connect their F-Droid app to your Butter
|
||||
Box and start downloading apps.
|
||||
|
||||
|
||||
|
||||
### Step 1: Install F-Droid Server Tools
|
||||
|
||||
Before you begin, you need to install a tool called **fdroidserver**. This
|
||||
helps you create and manage your app store.
|
||||
|
||||
**On Mac (using Homebrew):**
|
||||
|
||||
```
|
||||
brew install fdroidserver
|
||||
```
|
||||
|
||||
**On Linux (Debian/Ubuntu):**
|
||||
|
||||
```
|
||||
sudo apt install fdroidserver
|
||||
```
|
||||
|
||||
### Step 2: Check that it's installed correctly
|
||||
|
||||
After installation, run this command:
|
||||
|
||||
```
|
||||
fdroid version
|
||||
```
|
||||
|
||||
If everything is working, you will see a version number printed on the
|
||||
screen.
|
||||
|
||||
### Step 3: Create Your Repo Folder
|
||||
|
||||
You need to create the folder where you will save the repo files in your
|
||||
computer, choose a name that aligns with the project or purpose of the apps
|
||||
in it, and replace my-fdroid-repo for that name in the command.
|
||||
|
||||
```
|
||||
mkdir -p ~/my-fdroid-repo
|
||||
```
|
||||
|
||||
```
|
||||
cd ~/my-fdroid-repo
|
||||
```
|
||||
|
||||
### Step 4: Initialize the repo
|
||||
|
||||
```
|
||||
fdroid init
|
||||
```
|
||||
|
||||
This creates the following directories in your repo file:
|
||||
|
||||
```
|
||||
Config.yml
|
||||
```
|
||||
|
||||
```
|
||||
repo/
|
||||
```
|
||||
|
||||
```
|
||||
metadata/
|
||||
```
|
||||
|
||||
### Step 5: Add your APKs
|
||||
|
||||
Copy your signed APKs into the repo/ folder. Ensure you only use apps from
|
||||
trusted sources like the official F-Droid library or verified developers.
|
||||
|
||||
**Security Note:** Avoid downloading APKs from "mirror" sites or unknown sources, as they can contain malware or trackers that compromise your users' privacy.
|
||||
|
||||
```
|
||||
cp /path/to/your/*.apk repo/
|
||||
```
|
||||
|
||||
Example:
|
||||
|
||||
```
|
||||
cp ~/Downloads/myapp.apk repo/
|
||||
```
|
||||
|
||||
### Step 6: Generate (and Update) the Repository Index
|
||||
|
||||
Every time you add a new APK or a new version of an app to your repo/
|
||||
folder, you must run the following command to "publish" those changes:
|
||||
|
||||
```
|
||||
fdroid update --create-metadata
|
||||
```
|
||||
|
||||
What this command does:
|
||||
|
||||
* **Scans APKs:** It reads the new files in your repo/ folder.
|
||||
* **Generates Metadata:** It creates YAML files containing the app's name,
|
||||
version, and permissions.
|
||||
* **Creates index.v1.jar:** This is the "catalog" file that the F-Droid app
|
||||
downloads to see what is available.
|
||||
* **Signs the Repository:** It uses your secret key to sign the index,
|
||||
proving to the Android app that the files haven't been tampered with.
|
||||
|
||||
### Step 7: Test your Repo locally
|
||||
|
||||
To test your repo locally and ensure everything works before you share it on
|
||||
the Butter Box, you can serve its content locally and add it to F-Droid
|
||||
using a URL.
|
||||
|
||||
```
|
||||
cd repo
|
||||
```
|
||||
|
||||
```
|
||||
python3 -m http.server 8000
|
||||
```
|
||||
|
||||
Once your repo is live, open the F-Droid app on your device and navigate to **Settings > Repositories > "+"**. Select **"Enter repository URL manually"** to add your new source.
|
||||
|
||||
Adding the repo manually allows you to verify the user experience by
|
||||
checking:
|
||||
|
||||
* **App Visibility:** Are all your apps appearing in the list?
|
||||
* **Visual Assets:** Are icons and screenshots displaying correctly?
|
||||
* **Categorization:** Are apps appearing in the correct sections (e.g.,
|
||||
Internet, Security)?
|
||||
* **Functionality:** Do the downloads and installations complete without
|
||||
errors?
|
||||
* **Metadata:** Does the version number and description match your `repo/`
|
||||
files?
|
||||
|
||||
|
||||
|
||||
Your repo will be available at:
|
||||
|
||||
`http://YOUR-IP:8000/repo`
|
||||
|
||||
|
||||
|
||||
**Find your IP:**
|
||||
|
||||
#### macOS:
|
||||
|
||||
```
|
||||
ipconfig getifaddr en0
|
||||
```
|
||||
|
||||
#### Linux:
|
||||
|
||||
```
|
||||
hostname -I
|
||||
```
|
||||
|
|
@ -1,50 +0,0 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Apps
|
||||
|
||||
You can share apps as a content pack, via a static website. If you give a
|
||||
folder the name `appstore` and place it in the root directory of the USB
|
||||
drive, the **Apps** tile will appear in the Butter Box portal.
|
||||
|
||||
**Things To Know**
|
||||
|
||||
* If you are sharing apps from Butter Box, you will need to download the app
|
||||
files you want to share. Apps are updated frequently. Be sure to manually
|
||||
update all of the app files frequently to ensure you are providing the
|
||||
highest security for the people who connect to the box.
|
||||
* You’ll need a copy of the app’s `.apk` file — make sure it’s from a safe
|
||||
and trusted source.
|
||||
* Butter won’t automatically verify the source, so it's up to you to
|
||||
confirm it's clean and legal to share.
|
||||
* How to get apk files: There are mobile apps you can use to get access to
|
||||
apk files on an Android phone. Alternatively, you can download app files
|
||||
directly from the developer's website.
|
||||
|
||||
### Go Further: Butter Box Supports Sharing Via F-Droid
|
||||
|
||||
Additionally, Butter Box supports app distribution via F-Droid. In your
|
||||
content pack, you can include the F-Droid `.apk` and a QR code for your
|
||||
repo. Anyone with access to the Box can then download the F-Droid app while
|
||||
offline, and add the repo.
|
||||
|
||||
As long as they are connected to the Butter Box, they can download any of
|
||||
the apps within your repo.
|
||||
|
||||
If they are connected to the internet later, they can receive app updates
|
||||
from any apps in your repo that are also included in the official F-Droid
|
||||
repo. If you update the apps in your repo, they will also have access to
|
||||
those.
|
||||
|
||||
What is a F-Ddroid Repo?
|
||||
|
||||
* A hosted library of apps\ Why use it?
|
||||
* It offers a secure process for sharing apps. The F-Droid team builds apps
|
||||
in the official F-Droid repo from the source code themselves. This ensures
|
||||
that the app you download exactly matches the code the developer
|
||||
published.
|
||||
* Users installing from F-Droid have access to app updates remotely (away
|
||||
from the Butter Box)
|
||||
|
||||
Technical skills are required to create your own F-Droid repo. Refer to the
|
||||
[F-Droid Repo](f-droid-repo) Section for instructions.
|
||||
|
|
@ -1,72 +0,0 @@
|
|||
---
|
||||
description: 'Curated pluggable content'
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Content Packs
|
||||
|
||||
You can create your own content pack! It simply needs to be set up as a
|
||||
**static website with local links**. This website will run from the box
|
||||
itself, so all of the images and files required for the website need to be
|
||||
contained within one main folder.
|
||||
|
||||
Once you have your static website ready, you will put all of the required
|
||||
files for it in one folder, and place this folder in the **root directory**
|
||||
of your USB drive. This website will be rendered in the browser people use
|
||||
to access the Butter Box portal.
|
||||
|
||||
Tips for creating a content pack with a static website:
|
||||
|
||||
* **Contents.** Everything for the static website must be stored on a USB
|
||||
drive that plugs into the Butter Box. It should not link to resources on
|
||||
the global internet.
|
||||
* **Size.** The size of your content pack is limited by the amount of space
|
||||
available on your USB drive. Though, keep in mind that if multiple people
|
||||
are downloading or watching really large files from the box, there may be
|
||||
some latency.
|
||||
* **Pages.** Links between pages should point to other saved pages in the
|
||||
same folder, not to the internet. You must use relative paths
|
||||
(e.g. about/index.html) instead of absolute web URLs.
|
||||
* **Media.** Pictures, videos, and sounds cannot be linked to from somewhere
|
||||
online. The files need to be in your website folder and stored on the USB
|
||||
drive.
|
||||
* **Libraries.** The website cannot use javascript libraries that rely on an
|
||||
internet connection.
|
||||
* **Styles.** Special fonts and icons (like those from Google Fonts) also
|
||||
need to be packed into the folder, not fetched from the web.
|
||||
|
||||
### Try It
|
||||
|
||||
* The zip file below contains a sample static website. To get a feel for how
|
||||
static websites work with butter—Download it. Unzip it. Then, add this set
|
||||
of files to your USB drive.
|
||||
|
||||
[Sample Static Website.zip](/img/docs/Sample%20Static%20Website.zip)
|
||||
|
||||
You can also check out our [New Content Pack News](/docs/content-packs).
|
||||
|
||||
### Get Started
|
||||
|
||||
The best way to get started with creating your own content pack is to have
|
||||
an idea about the experience and type of information you want to provide,
|
||||
and then to design and build a local static website for it.
|
||||
|
||||
It can be very simple like an audio player for music. Or, a simple list of
|
||||
the five top VPN apps that you recommend. Or it can be more complex like a
|
||||
library or knowledge base of cultural artifacts.
|
||||
|
||||
|
||||
|
||||
### Add website files to a USB drive
|
||||
|
||||
Place a folder with your website files in the **root directory** of a USB
|
||||
drive. Be sure that your website folder contains your **index.html.** The
|
||||
name of this folder will be displayed on the Butter Box portal.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.46.16 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
|
||||
### Connect to your Butter Box to view
|
||||
|
||||
Insert the USB drive into your Butter Box. When you open the Butter Box
|
||||
portal, tap **Files**. Navigate to the website folder. Tap to view.
|
||||
|
||||
|
|
@ -1,41 +0,0 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
# Maps
|
||||
|
||||
You can make offline maps available from your Butter Box. These maps are
|
||||
powered by **OpenStreetMap (OSM)** and the **OsmAnd app** for Android.
|
||||
|
||||
:::warning
|
||||
**Important:** Offline map downloads work **only on Android devices**. iOS is not supported.
|
||||
:::
|
||||
|
||||
### ✅ Steps to Enable Maps
|
||||
|
||||
**1. Download the map files you need**
|
||||
|
||||
* Visit: [OsmAnd Local Indexes
|
||||
List](https://osmand.net/list?sortby=size\&asc=false)
|
||||
* Choose and download the regions you want available offline.
|
||||
|
||||
**2. Organize your files**
|
||||
|
||||
* On your USB drive, create a folder named `osm-map-files` .
|
||||
* Put the **OsmAnd APK** and all your **map files** into this folder.
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.44.40 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
|
||||
**3. Add to your Butter Box**
|
||||
|
||||
* Insert the USB drive into your Butter Box.
|
||||
* The **Offline Maps** tile will automatically appear in your Butter Box
|
||||
portal.
|
||||
|
||||
👉 That’s it — anyone using an **Android device** can now download OsmAnd and
|
||||
the offline maps you’ve provided directly from your Butter Box.
|
||||
|
||||
Note: The OSM map apk is available on the Butter Box software image. Updates
|
||||
to the OsmAnd app will be available with new releases of the Butter Box
|
||||
software. If you want to know what the latest available version of OsmAnd
|
||||
app is, visit [OsmAnd Free Releases —
|
||||
Android](https://osmand.net/docs/versions/free-versions).
|
||||
|
|
@ -1,68 +0,0 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
# How to Reformat Your USB Drive
|
||||
|
||||
After connecting your USB drive to the Raspberry Pi you will see the
|
||||
“Explore USB” title displayed on the portal. If you’ve tried refreshing your
|
||||
portal page and still do not see the “Explore USB” tile then you may need to
|
||||
erase your USB stick and reformat it.
|
||||
|
||||
<br/>
|
||||
|
||||
|
||||
|
||||
When you format a USB drive, all files and folders on the drive are removed and replaced with a new file system. This can help repair any issues with the flash drive itself or make it compatible with new files you want to transfer. Be sure to back up your files before formatting your drive. <br/>
|
||||
|
||||
**Check the Format of the USB**
|
||||
|
||||
* On your desktop or laptop, plug in your USB
|
||||
* Right, or double-click on the USB
|
||||
* Click on “Get info” and verify the Format
|
||||
* Your USB needs to be formatted to ExFat or Fat32, MS-DOS (FAT).
|
||||
|
||||
|
||||
|
||||
**Reformatting Steps on MacOS:**
|
||||
|
||||
* Connect the USB drive to a USB port on your computer.
|
||||
* Right, or double-click on the USB
|
||||
* Click on “Erase Disk…”
|
||||
* You can rename your USB at this time
|
||||
* Select the correct format, either ExFat or ExFat32 or MS-DOS (FAT)
|
||||
* Then tap “Erase”
|
||||
* A message may appear warning you that all content will be deleted. Select
|
||||
“Erase”
|
||||
* This may take a few minutes. The USB will disappear and reappear on your
|
||||
homescreen
|
||||
* Verify the drive is correctly formatted
|
||||
* Right, or double-click on the USB
|
||||
* Click on “Get info” and verify the Format<br/>
|
||||
|
||||
**Reformatting Steps on Windows:**
|
||||
|
||||
* Connect the USB drive to a USB port on your computer.
|
||||
* Open the File Explorer and select "This PC" from the menu.
|
||||
* You can find this option in the left panel, next to a monitor
|
||||
icon.[\[2\]](https://www.wikihow.com/Format-a-Flash-Drive#_note-2)
|
||||
* On Windows 7, click Computer on the right side of the Start window.
|
||||
* Right-click the flash drive's icon. It's beneath the "Devices and drives"
|
||||
heading in the middle of the page. This will bring up a drop-down menu.
|
||||
* Choose "Format". This will open the formatting window.
|
||||
* Click on "File System" and choose the MS-DOS, FAT32, or exFAT format.
|
||||
* [FAT32](https://www.wikihow.com/Format-FAT32) - The most widely compatible
|
||||
format. Works with most computers and gaming consoles.
|
||||
* exFAT - Similar to FAT32, but designed for external hard drives (e.g.,
|
||||
flash drives) and quicker use. It's a universal format that is most common
|
||||
across Windows, Linux, and Mac.
|
||||
* Select "Start" and click "OK" to finish formatting your flash drive.
|
||||
* A final prompt will appear, Click “OK”. Your flash drive has successfully
|
||||
been formatted.<br/>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
<br/>
|
||||
|
|
@ -1,77 +0,0 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# FAQ
|
||||
|
||||
### Does the Butter Box give me the internet?
|
||||
|
||||
Not quite. The Butter Box doesn’t provide internet access. Instead, it
|
||||
creates its own local Wi-Fi network that lets you access apps, content
|
||||
(previously set up), and message board features offline . Everything is
|
||||
stored and shared locally — no internet or data connection needed.
|
||||
|
||||
***
|
||||
|
||||
### How do you power a Butter Box?
|
||||
|
||||
The Butter Box is super flexible! You can power it using a USB power bank, a
|
||||
wall adapter, or even a small solar panel. As long as it provides power to
|
||||
the Raspberry Pi, you’re good to go. Go to the [Power
|
||||
Supply](../build-a-box/power-supply) section to learn more.
|
||||
|
||||
***
|
||||
|
||||
### If I’m powering the Butter Box with a solar panel, do I need a power bank?
|
||||
|
||||
A power bank isn’t strictly required, but it’s highly recommended. Solar
|
||||
panels can be inconsistent — clouds, shade, or changing sunlight can
|
||||
interrupt power. A power bank helps smooth that out by storing energy and
|
||||
keeping the Butter Box running steadily, even when sunlight dips. Check it
|
||||
out this use case to know more: (insert use case URL)
|
||||
|
||||
***
|
||||
|
||||
### What are the security features of the Butter Box? Can I put a password on it?
|
||||
|
||||
Currently, the Butter Box broadcasts an open Wi-Fi network — that means no
|
||||
password is required to connect. This makes it easy for people nearby to
|
||||
join, especially in offline or community settings.
|
||||
|
||||
However, users must either enter the Butter Box’s local IP address manually,
|
||||
or scan a QR code that takes them directly to the content. Since it’s all
|
||||
offline, there’s no exposure to the internet or external threats.
|
||||
|
||||
You can configure the Raspberry Pi to require a Wi-Fi password in the admin
|
||||
settings. Refer to the [Security](../security) section for more security
|
||||
features.
|
||||
|
||||
***
|
||||
|
||||
### How much storage does a Butter Box have?
|
||||
|
||||
The Butter Box storage capacity is defined by the microSD card you install —
|
||||
it doesn’t have fixed built-in memory. You can choose anything from a 16 GB
|
||||
card up to 1 TB (the Raspberry Pi Zero 2 W supports microSD sizes up to
|
||||
that). We recommend 256 GB.
|
||||
|
||||
| Use Case | Suggested micro SD Size |
|
||||
| ------------------------------------- | -------------------------- |
|
||||
| Basic setup (apps + message board) | 16 GB – 32 GB |
|
||||
| Additional content or media storage | 64 GB – 128 GB |
|
||||
| Handling large content packs or files | 256 GB or more, up to 1 TB |
|
||||
|
||||
***
|
||||
|
||||
### Can I customize it?
|
||||
|
||||
Absolutely! You can add, for example, your own content - dropping in PDFs,
|
||||
videos, images, and HTML pages to build a local library, or add your own
|
||||
apps - including Android APKs (even if they’re not on F-Droid).
|
||||
|
||||
***
|
||||
|
||||
### My USB drive is plugged into the Butter Box, but the content is not displayed on the portal. Why?
|
||||
|
||||
Yout USB drive is probably in the wrong format. Your USB needs to be
|
||||
formatted to ExFat, Fat32, MS-DOS (FAT). Refer to [Reformatting Your
|
||||
USB](how-to-reformat-your-usb-drive) for help.
|
||||
|
|
@ -1,17 +0,0 @@
|
|||
---
|
||||
description: 'Sharing offline has never been easier!'
|
||||
sidebar_position: 1
|
||||
---
|
||||
|
||||
# Get Started
|
||||
|
||||
Butter Box is a lightweight, portable device that functions like a hard
|
||||
drive with its own hotspot. Anyone nearby can connect to it and view or
|
||||
download its contents—no internet required.
|
||||
|
||||
Whether you have a Butter Box in your hands or you need to build one, you're
|
||||
in the right spot. Choose an option below.
|
||||
|
||||
## [I Have A Box](quick-start.mdx) ...or... [I Need A Box](build-a-box/)
|
||||
|
||||
|
||||
|
|
@ -1,88 +0,0 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
# Quick Start
|
||||
|
||||
If you have a Butter Box with the latest version of the Butter software
|
||||
loaded on the SD card, take these quick steps to get set up.
|
||||
|
||||
### Check supplies
|
||||
|
||||
Make sure you have the supplies for a basic box:
|
||||
|
||||
* [ ] Power source
|
||||
* [ ] USB drive
|
||||
* [ ] USB Adapters (as needed)
|
||||
* [ ] Butter Box Device (with micro SD card inserted)
|
||||
* [ ] Case
|
||||
|
||||
<figure><img src="/img/docs/signal-2025-08-21-140334_003.jpeg" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
### Make sure the micro SD card is inserted into the device
|
||||
|
||||
The micro SD card should have the latest version of Butter OS running on it.
|
||||
|
||||
### Plug it in to power on
|
||||
|
||||
Connect the power supply to the first micro USB port and correct wall
|
||||
outlet.
|
||||
|
||||
<figure><img src="/img/docs/1.png" alt="" width="375"/><figcaption></figcaption></figure>
|
||||
|
||||
You will know the box is working if ‘butterbox’ wifi appears in the wifi
|
||||
list on your phone or computer. If it doesn’t, unplug the box and plug it
|
||||
back in.
|
||||
|
||||
|
||||
|
||||
_If using a solar battery or other means of power, use one with the correct
|
||||
specs to ensure adequate power and avoid damage to the unit. For a Pi Zero 2
|
||||
W use Micro USB power supply with at least 2.0A._
|
||||
|
||||
[Link to Power Supply Options](build-a-box/power-supply)
|
||||
|
||||
|
||||
|
||||
### Insert USB drive
|
||||
|
||||
Connect the USB adapter to the open port. Then plug in the USB drive. Learn
|
||||
more about loading the USB drive with treasures in the [File
|
||||
Sharing](services/file-sharing) section.
|
||||
|
||||
<figure><img src="/img/docs/2.png" alt="" width="375"/><figcaption></figcaption></figure>
|
||||
|
||||
### Access the Butter Box Portal
|
||||
|
||||
Join the ‘butterbox’ Wi-Fi. After 30 seconds, scan the QR code on the
|
||||
box. This connects you to **http://butterbox.local** in a browser.
|
||||
|
||||
[https://youtu.be/KB5O9MSoaAg](https://youtu.be/KB5O9MSoaAg)
|
||||
|
||||
<div align="center"><figure><img src="/img/docs/qr code.png" alt="" width="375"/><figcaption></figcaption></figure></div>
|
||||
|
||||
_If this page does not load, wait a few minutes to ensure
|
||||
connectivity. Refresh the page. If you’re connecting from a smartphone, turn
|
||||
off your mobile data or turn on airplane mode. Then try again._
|
||||
|
||||
:::info
|
||||
This is an HTTP page, not HTTPS, because it's served from a local device with no internet connection. Your data never leaves the network, so it's still private and secure.
|
||||
:::
|
||||
|
||||
The Wi-Fi does not have a password by default. Though, you can easily add
|
||||
one in the Admin Settings.
|
||||
|
||||
### Once connected, use Admin Settings to set up your box.
|
||||
|
||||
The admin setup wizard is designed to give you choice over which services
|
||||
are offered on the box and to increase its security. You will be prompted to
|
||||
go to Admin Settings if this is the first time you've used the box.
|
||||
|
||||
### Share access to the portal
|
||||
|
||||
Once you share with others, they will connect to it in the same way you just
|
||||
did.
|
||||
|
||||
:::info
|
||||
For a Pi Zero 2 W: Up to 5 people can connect to the box at any time. After people connect and get what they need, encourage them to leave the box to give others a turn.\
|
||||
The physical reach of the Box varies. But as a rule of thumb, people in the same room as the box (or in talking distance) will be able to access it.
|
||||
:::
|
||||
|
|
@ -1,202 +0,0 @@
|
|||
---
|
||||
description: 'How to Make a Butter Box Tamper Resistant'
|
||||
sidebar_position: 7
|
||||
---
|
||||
|
||||
# Security
|
||||
|
||||
This guide was designed for deployments in hostile, semi-hostile, or
|
||||
low-trust environments, where devices may be inspected, confiscated,
|
||||
modified, or misused. It aims to provide practical recommendations to make
|
||||
the Butter Box more physically and digitally tamper-resistant.
|
||||
|
||||
Following the recommendations in this guide will help reduce risk, not
|
||||
guarantee absolute security. Butter Box is assumed to be a field-deployable,
|
||||
low-cost, offline system, so these recommendations prioritize realistic,
|
||||
maintainable protections.
|
||||
|
||||
**Threat Model Assumptions**
|
||||
|
||||
Before applying controls, clearly define your deployment context. This guide
|
||||
assumes one or more of the following risks:
|
||||
|
||||
* Physical access by unauthorized users
|
||||
* Device confiscation or inspection by authorities
|
||||
* Curious or malicious local users
|
||||
* Content manipulation or replacement
|
||||
* Network misuse or impersonation
|
||||
* Credential reuse or default configuration abuse
|
||||
|
||||
Remember that controls should adapt to the local risk level, over-hardening
|
||||
can reduce usability and trust.
|
||||
|
||||
|
||||
|
||||
### Section 1: Physical Tamper Resistance
|
||||
|
||||
#### Enclosure and Hardware Protection
|
||||
|
||||
Physical access to the Butter Box allows SD card cloning, firmware
|
||||
replacement, malware injection and broadcasting of malicious
|
||||
information. PCB are also delicate and should have additional protection to
|
||||
keep them safe from everyday handling and weather exposure.
|
||||
|
||||
Recommendations:
|
||||
|
||||
1. Use a sealed or semi-sealed enclosure (screws instead of snap-fit)
|
||||
2. Prefer tamper-evident screws (Torx, security hex)
|
||||
3. Apply tamper-evident stickers over enclosure seams and SD card slots
|
||||
|
||||
| 1) Sealed enclosures | 2) Screws |
|
||||
| --------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
|
||||
#### 
|
||||
|
||||
#### SD Card & Storage Protection
|
||||
|
||||
Recommendations:
|
||||
|
||||
1. Use high-quality SD cards to reduce corruption
|
||||
2. Encrypt sensitive partitions (where feasible)
|
||||
3. Keep content and OS separated (firmware vs content packs)
|
||||
4. Avoid labeling SD cards with sensitive identifiers
|
||||
|
||||
Optional (higher risk contexts):
|
||||
|
||||
1. Epoxy Resin. Electronico potting solutions protect Printed Circuit
|
||||
Boards from extreme temperatures, moisture, vibration, and other
|
||||
environmental threats.
|
||||
2. Physically block SD card removal
|
||||
|
||||
|
||||
|
||||
| Epoxy Resin | Epoxy Resin |
|
||||
| --------------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
|
||||
#### 
|
||||
|
||||
#### Power & Port Management
|
||||
|
||||
Recommendations:
|
||||
|
||||
1. Disable or physically block unused ports (USB, HDMI). Inexpensive
|
||||
physical port blockers can be used to reduce the risk of tampering with
|
||||
the Butter Box by preventing unauthorized access to exposed
|
||||
interfaces. These blockers limit the ability of bad actors to inject
|
||||
malicious code, connect unauthorized peripherals, or broadcast unwanted
|
||||
content. Ports are sealed with plastic blockers that can only be removed
|
||||
using a dedicated key included in the deployment kit.
|
||||
2. Avoid exposing Ethernet ports unless required. Ethernet ports should
|
||||
remain disabled or physically blocked unless they are explicitly required
|
||||
for the deployment. When Ethernet access is necessary, its use should be
|
||||
clearly documented and limited to trusted operators.
|
||||
3. Use short internal cables to reduce easy probing
|
||||
4. Label power banks generically (avoid project names)
|
||||
|
||||
| USB & HDMI | Ethernet Ports |
|
||||
| --------------------------------------- | --------------------------------------- |
|
||||
|  |  |
|
||||
|
||||
#### Environmental & Operational Practices
|
||||
|
||||
Recommendations:
|
||||
|
||||
* Store boxes in controlled locations when not in use
|
||||
* Rotate devices periodically in long deployments
|
||||
* Assume devices may be copied or lost
|
||||
* Treat Butter Boxes as semi-disposable infrastructure, not personal
|
||||
devices.
|
||||
|
||||
### Section 2: Digital Tamper Resistance
|
||||
|
||||
#### Credential Hygiene (Critical)
|
||||
|
||||
Mandatory actions:
|
||||
|
||||
SSH
|
||||
|
||||
* By default, the pi user has the password butterbox-admin.
|
||||
* Change this password by sshing into the pi and running passwd.
|
||||
* If you'd prefer to use an SSH key, be sure to disable password access once
|
||||
you enable key-based access.
|
||||
|
||||
RaspAP
|
||||
|
||||
* The access point has an administrative interface that can be used to
|
||||
change its settings.
|
||||
* Defaults: user: admin, password: secret (ironically, this is not secret).
|
||||
* Change this by logging in at
|
||||
[http://butterbox.lan/admin](http://butterbox.lan/admin) (or
|
||||
[http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin)
|
||||
for a Spanish language box) and using the Web UI.
|
||||
|
||||
Chat
|
||||
|
||||
* The local chat was created by an administrative user called
|
||||
butterbox-admin. The password for this user is also butterbox-admin.
|
||||
* Change this password by logging into the Butter Box, going to the public
|
||||
chatroom, then visiting your user profile and updating the password. At
|
||||
your discretion, you may also wish to change the name from butterbox-admin
|
||||
so that other users will recognize you.
|
||||
|
||||
Best practices:
|
||||
|
||||
* Use unique passwords per deployment
|
||||
* Store credentials offline in secure documentation
|
||||
* Never reuse credentials across regions
|
||||
|
||||
#### Service Hardening
|
||||
|
||||
Recommendations:
|
||||
|
||||
* Disable services not strictly required:
|
||||
* SSH (or restrict to key-based auth)
|
||||
* Bluetooth
|
||||
* USB ports
|
||||
|
||||
#### Content Integrity & Authenticity
|
||||
|
||||
Recommendations:
|
||||
|
||||
* Keep firmware immutable during normal operation
|
||||
* Maintain a known-good baseline image
|
||||
* Re-flash devices periodically in long deployments
|
||||
|
||||
Operational control:
|
||||
|
||||
* Only trusted operators should install or update content
|
||||
* Document update sources and dates
|
||||
|
||||
|
||||
|
||||
### Section 3: Misuse & Abuse Mitigation
|
||||
|
||||
#### Local Chat & Content Abuse
|
||||
|
||||
Risks:
|
||||
|
||||
* Harassment or hate speech
|
||||
* Impersonation
|
||||
* Disinformation spread
|
||||
|
||||
Mitigations:
|
||||
|
||||
* Clear usage guidelines displayed locally
|
||||
* Community moderation roles (if appropriate)
|
||||
* Ability to reset or wipe chat data quickly
|
||||
* Limit who can upload or replace content
|
||||
* Keep a read-only mode for most users
|
||||
|
||||
|
||||
|
||||
### Section 4: Incident Response & Recovery
|
||||
|
||||
Prepare for compromise:
|
||||
|
||||
* Assume some devices will be tampered with
|
||||
* Maintain a simple wipe and re-flash procedure
|
||||
* Track deployments
|
||||
|
||||
<br/>
|
||||
|
|
@ -1,59 +0,0 @@
|
|||
---
|
||||
sidebar_position: 2
|
||||
---
|
||||
# File Sharing
|
||||
|
||||
<figure><img src="/img/docs/media-type-explore.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
## Share Media, Files and Digital Books
|
||||
|
||||
You can use your Butter Box to share media, files, and digital books. To
|
||||
display additional content in your portal, connect a USB drive containing
|
||||
the information you want to share.
|
||||
|
||||
If you’d like more control over how your content is displayed, you can build
|
||||
a **static website** and share it through the Butter Box. Learn more in the
|
||||
[Content Packs](../content-packs/) section.
|
||||
|
||||
|
||||
|
||||
### Add files to your USB Drive
|
||||
|
||||
Place individual files directly in the **main directory** (root) of your USB
|
||||
drive. Or, create folders to organize your files (eg. "Books", "Music",
|
||||
"Reports)
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2025-08-16 at 9.50.15 PM.png" alt=""/><figcaption><p>USB directory when viewed in Finder on desktop</p></figcaption></figure>
|
||||
|
||||
**Things to Know**
|
||||
|
||||
* The **folder names you use** on your USB drive will be shown in the Butter
|
||||
Box portal.
|
||||
* Organizing content into folders makes it easier for others to browse and
|
||||
download.
|
||||
|
||||
### Connect to your Butter Box to view
|
||||
|
||||
Insert the USB drive into your Butter Box. After connecting your USB drive
|
||||
to the Raspberry Pi you will see the **Files** tile displayed when you open
|
||||
the Butter Box portal.
|
||||
|
||||
<div><figure><img src="/img/docs/Screenshot_20260414-122810.png" alt=""/><figcaption></figcaption></figure> <figure><img src="/img/docs/Screenshot_20260414-122821.png" alt=""/><figcaption></figcaption></figure></div>
|
||||
|
||||
|
||||
|
||||
**Troubleshooting**
|
||||
|
||||
If you don’t see the **Files** tile, try the following actions:
|
||||
|
||||
* Remove the USB drive from the Butter Box. Then re-insert the USB drive.
|
||||
* Turn on/off airplane mode. Reconnect Butter Box wifi.
|
||||
* Refresh the browser page.
|
||||
|
||||
If you are still having trouble you may need to [Reformat Your USB
|
||||
Drive](../faq/how-to-reformat-your-usb-drive).
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -1,5 +0,0 @@
|
|||
---
|
||||
sidebar_position: 1
|
||||
---
|
||||
# Features
|
||||
|
||||
|
|
@ -1,110 +0,0 @@
|
|||
---
|
||||
description: 'A place for anyone connected to the box to share'
|
||||
sidebar_position: 3
|
||||
---
|
||||
|
||||
# Local Chat
|
||||
|
||||
There is one local chat on your Butter Box that is open to anyone who is
|
||||
able to join the box. If they can open the portal, they can open the chat
|
||||
and say or post anything they want. Depending on your use case, moderation
|
||||
capabilities may be important.
|
||||
|
||||
First, let's look at what you can and can't do with this local chat.
|
||||
|
||||
✅ **You Can**<br/>
|
||||
|
||||
* Host videos up to 5 GB PDFs, images, record, audio messages, share
|
||||
pre-recorded audio messages or music
|
||||
* Download the full chat or any individual piece of content or media that
|
||||
people have shared
|
||||
|
||||
❌ **You Cannot**<br/>
|
||||
|
||||
* Use the chat to talk with people who are not connected to the Butter Box
|
||||
* Get notifications when there are new posts or messages
|
||||
* See the messages unless you are connected to the Butter Box
|
||||
|
||||
|
||||
|
||||
## Moderation
|
||||
|
||||
A Butter Box offers moderation features for the local chat. In order to
|
||||
access these features, you need to login as the admin of the room.
|
||||
|
||||
### Become the Admin
|
||||
|
||||
### Logout as Guest
|
||||
|
||||
When you open the local chat, you are assigned a guest identity. First
|
||||
logout of the account that was created for you.
|
||||
|
||||
### Login as Admin
|
||||
|
||||
Login to the `butterbox-admin` account. Username and password are both
|
||||
`butterbox-admin`.
|
||||
|
||||
### Change Admin Password
|
||||
|
||||
Visit your user profile to change the password. At your discretion, you may
|
||||
also wish to change your display name so that other users will recognize
|
||||
you.
|
||||
|
||||
### Moderation Features
|
||||
|
||||
Once you are an admin, you have access to the following features:
|
||||
|
||||
* **Set a message timer**
|
||||
* **Delete messages**
|
||||
* **Promote members to moderator or admin**
|
||||
* **Kick members out.**
|
||||
* Keep in mind that someone can simply rejoin as a new guest if they
|
||||
reconnect to the box
|
||||
* **Delete the room.**
|
||||
* Warning: If you delete the room, you will no longer have a local chat on
|
||||
your Butter Box. To get one back, you will have to flash a new image of
|
||||
the Butter Box software to your SD card.
|
||||
|
||||
|
||||
|
||||
## Say Even More—Direct Messages and Private Rooms
|
||||
|
||||
In addition to the local chat, you can create any number of private rooms
|
||||
from the same interface.
|
||||
|
||||
### Things To Know
|
||||
|
||||
* Each room will have it's own QR code.
|
||||
* Private rooms are not discoverable from the Butter Box portal.
|
||||
* If you create a private room, you have to share the QR code physically to
|
||||
whomever you want to join **who is also connected to the box.**
|
||||
* Every private chat that you are part of, will be easy for **you** to
|
||||
find. They will all show up in your room list.
|
||||
|
||||
### Instructions
|
||||
|
||||
You can create a private room from two different places in the message board
|
||||
interface.
|
||||
|
||||
### Open from Avatar Modal
|
||||
|
||||
Tap on your avatar in the top bar. Select **new room.**
|
||||
|
||||
| <img src="/img/docs/image.png" alt="" data-size="original"/> | |
|
||||
| -------------------------------------------------------------------- | - |
|
||||
|
||||
|
||||
|
||||
### Open from Room List
|
||||
|
||||
Your room list is accessible from your profile page. Once here, select **new
|
||||
room.**
|
||||
|
||||
<figure><img src="/img/docs/Screenshot 2026-01-20 at 1.42.17 PM.png" alt=""/><figcaption></figcaption></figure>
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
|
@ -1,17 +0,0 @@
|
|||
---
|
||||
description: 'Using Delta Chat with a Butter Box'
|
||||
sidebar_position: 4
|
||||
---
|
||||
|
||||
# Private Messenger
|
||||
|
||||
With the Private Messenger service, you can exchange secure messages with
|
||||
people you know. [Delta Chat](https://delta.chat/) is a messaging app that
|
||||
uses email protocols to exchange messages. When used through a Butter Box,
|
||||
people who create accounts on the same Butter Box can send messages to each
|
||||
other without the internet.
|
||||
|
||||
Think of the Butter Box like a local post office. Whenever you connect to
|
||||
the Box’s network, your Delta Chat app can send outgoing messages and sync
|
||||
to receive any new ones waiting for you.
|
||||
|
||||
|
|
@ -1,26 +0,0 @@
|
|||
---
|
||||
sidebar_position: 6
|
||||
---
|
||||
# Update Butter
|
||||
|
||||
### Check out new releases from the Butter Box team
|
||||
|
||||
[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
|
||||
:::
|
||||
|
||||
### Early Access Development Releases
|
||||
|
||||
WARNING: These are early releases posted for development testing and MUST
|
||||
NOT be used in production deployments.
|
||||
|
||||
[Download Early Access Development
|
||||
Images](https://files.sr2.uk/d/52bd8561a10d4d83be7b/?p=%2F&mode=list)
|
||||
|
||||
### Update your Butter Box
|
||||
|
||||
Update your Butter Box using the same guide with the steps you take when you
|
||||
are setting a Butter Box up for the first time. You can find it here:
|
||||
[Raspberry Pi Install](build-a-box/raspberry-pi/install-butter)
|
||||
|
|
@ -7,7 +7,7 @@
|
|||
msgid ""
|
||||
msgstr ""
|
||||
"Project-Id-Version: PACKAGE VERSION\n"
|
||||
"POT-Creation-Date: 2026-05-01 14:38+0100\n"
|
||||
"POT-Creation-Date: 2026-04-24 16:24+0100\n"
|
||||
"PO-Revision-Date: YEAR-MO-DA HO:MI+ZONE\n"
|
||||
"Last-Translator: FULL NAME <EMAIL@ADDRESS>\n"
|
||||
"Language-Team: LANGUAGE <LL@li.org>\n"
|
||||
|
|
@ -210,7 +210,7 @@ msgid ""
|
|||
"|\n"
|
||||
"| --------------------------------- | "
|
||||
"--------------------------------------- |\n"
|
||||
"|  |  |\n"
|
||||
"|  | .jpeg>) |\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ####
|
||||
|
|
@ -278,13 +278,13 @@ msgid ""
|
|||
"|\n"
|
||||
"| --------------------------------------- | "
|
||||
"--------------------------------------- |\n"
|
||||
"|  |  |\n"
|
||||
"| .jpeg>) | .jpeg>) |\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ####
|
||||
#: docs/security.mdx:65
|
||||
#, markdown-text, no-wrap
|
||||
msgid ""
|
||||
msgid ".jpeg>)"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ####
|
||||
|
|
@ -336,7 +336,7 @@ msgid ""
|
|||
"|\n"
|
||||
"| --------------------------------------- | "
|
||||
"--------------------------------------- |\n"
|
||||
"|  |  |\n"
|
||||
"| .jpeg>) | .jpeg>) |\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ####
|
||||
|
|
@ -366,7 +366,9 @@ msgstr ""
|
|||
#. type: Bullet: '* '
|
||||
#: docs/security.mdx:88
|
||||
#, markdown-text
|
||||
msgid "Treat Butter Boxes as semi-disposable infrastructure, not personal devices."
|
||||
msgid ""
|
||||
"Treat Butter Boxes as semi-disposable infrastructure, not personal "
|
||||
"devices.<br/>"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ###
|
||||
|
|
@ -437,9 +439,9 @@ msgstr ""
|
|||
#: docs/security.mdx:106
|
||||
#, markdown-text
|
||||
msgid ""
|
||||
"Change this by logging in at "
|
||||
"[http://butterbox.lan/admin](http://butterbox.lan/admin) (or "
|
||||
"[http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin) for "
|
||||
"Change this by logging in at[ "
|
||||
"http://butterbox.lan/admin](http://butterbox.lan/admin) (or[ "
|
||||
"http://comolamantequilla.lan/admin](http://comolamantequilla.lan/admin) for "
|
||||
"a Spanish language box) and using the Web UI."
|
||||
msgstr ""
|
||||
|
||||
|
|
@ -1777,7 +1779,7 @@ msgstr ""
|
|||
#: docs/build-a-box/raspberry-pi/install-butter.mdx:29
|
||||
#, markdown-text, no-wrap
|
||||
msgid ""
|
||||
"<div align=\"center\"><figure><img src=\"/img/docs/image_1.png\" alt=\"\" "
|
||||
"<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>\n"
|
||||
msgstr ""
|
||||
|
|
@ -2100,7 +2102,7 @@ msgstr ""
|
|||
#. type: Plain text
|
||||
#: docs/content-packs/index.mdx:28
|
||||
#, markdown-text
|
||||
msgid "You can also check out our [New Content Pack News](/docs/content-packs)."
|
||||
msgid "You can also check out our [New Content Pack News](/blog/tags/contentpack)."
|
||||
msgstr ""
|
||||
|
||||
#. type: Plain text
|
||||
|
|
@ -2976,19 +2978,21 @@ msgstr ""
|
|||
#. type: Plain text
|
||||
#: docs/faq/how-to-reformat-your-usb-drive.mdx:52
|
||||
#, markdown-text, no-wrap
|
||||
msgid "\n"
|
||||
msgid ""
|
||||
".png>)![](</img/docs/unknown "
|
||||
"(2).png>).png>)\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Plain text
|
||||
#: docs/faq/how-to-reformat-your-usb-drive.mdx:54
|
||||
#, markdown-text, no-wrap
|
||||
msgid "\n"
|
||||
msgid ".png>)\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Plain text
|
||||
#: docs/faq/how-to-reformat-your-usb-drive.mdx:56
|
||||
#, markdown-text, no-wrap
|
||||
msgid "\n"
|
||||
msgid ".png>)\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title #
|
||||
|
|
@ -3237,9 +3241,9 @@ msgstr ""
|
|||
#: docs/services/file-sharing.mdx:32
|
||||
#, markdown-text, no-wrap
|
||||
msgid ""
|
||||
"<div><figure><img src=\"/img/docs/Screenshot_20260414-122810.png\" "
|
||||
"<div><figure><img src=\"/img/docs/Screenshot_20260414-122810 (1).png\" "
|
||||
"alt=\"\"/><figcaption></figcaption></figure> <figure><img "
|
||||
"src=\"/img/docs/Screenshot_20260414-122821.png\" "
|
||||
"src=\"/img/docs/Screenshot_20260414-122821 (1).png\" "
|
||||
"alt=\"\"/><figcaption></figcaption></figure></div>\n"
|
||||
msgstr ""
|
||||
|
||||
|
|
|
|||
654
po4a/ru.po
654
po4a/ru.po
File diff suppressed because it is too large
Load diff
|
|
@ -1,7 +1,5 @@
|
|||
msgid ""
|
||||
msgstr ""
|
||||
"POT-Creation-Date: 2026-05-01 14:38+0100\n"
|
||||
"Last-Translator: Automatically generated\n"
|
||||
msgstr "Last-Translator: Automatically generated\n"
|
||||
|
||||
#. type: Yaml Front Matter Hash Value: description
|
||||
#: docs/index.mdx:1
|
||||
|
|
@ -178,7 +176,7 @@ msgstr ""
|
|||
msgid ""
|
||||
"| 1) Sealed enclosures | 2) Screws |\n"
|
||||
"| --------------------------------- | --------------------------------------- |\n"
|
||||
"|  |  |\n"
|
||||
"|  | .jpeg>) |\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ####
|
||||
|
|
@ -237,13 +235,13 @@ msgstr ""
|
|||
msgid ""
|
||||
"| Epoxy Resin | Epoxy Resin |\n"
|
||||
"| --------------------------------------- | --------------------------------------- |\n"
|
||||
"|  |  |\n"
|
||||
"| .jpeg>) | .jpeg>) |\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ####
|
||||
#: docs/security.mdx:65
|
||||
#, no-wrap
|
||||
msgid ""
|
||||
msgid ".jpeg>)"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ####
|
||||
|
|
@ -289,7 +287,7 @@ msgstr ""
|
|||
msgid ""
|
||||
"| USB & HDMI | Ethernet Ports |\n"
|
||||
"| --------------------------------------- | --------------------------------------- |\n"
|
||||
"|  |  |\n"
|
||||
"| .jpeg>) | .jpeg>) |\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ####
|
||||
|
|
@ -317,6 +315,7 @@ msgstr ""
|
|||
#: docs/security.mdx:88
|
||||
msgid ""
|
||||
"Treat Butter Boxes as semi-disposable infrastructure, not personal devices."
|
||||
"<br/>"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title ###
|
||||
|
|
@ -379,8 +378,8 @@ msgstr ""
|
|||
#. type: Bullet: '* '
|
||||
#: docs/security.mdx:106
|
||||
msgid ""
|
||||
"Change this by logging in at [http://butterbox.lan/admin](http://"
|
||||
"butterbox.lan/admin) (or [http://comolamantequilla.lan/admin](http://"
|
||||
"Change this by logging in at[ http://butterbox.lan/admin](http://"
|
||||
"butterbox.lan/admin) (or[ http://comolamantequilla.lan/admin](http://"
|
||||
"comolamantequilla.lan/admin) for a Spanish language box) and using the Web "
|
||||
"UI."
|
||||
msgstr ""
|
||||
|
|
@ -1558,7 +1557,7 @@ msgstr ""
|
|||
#. type: Plain text
|
||||
#: docs/build-a-box/raspberry-pi/install-butter.mdx:29
|
||||
#, no-wrap
|
||||
msgid "<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>\n"
|
||||
msgid "<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>\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Fenced div block (info)
|
||||
|
|
@ -1835,7 +1834,7 @@ msgstr ""
|
|||
#. type: Plain text
|
||||
#: docs/content-packs/index.mdx:28
|
||||
msgid ""
|
||||
"You can also check out our [New Content Pack News](/docs/content-packs)."
|
||||
"You can also check out our [New Content Pack News](/blog/tags/contentpack)."
|
||||
msgstr ""
|
||||
|
||||
#. type: Plain text
|
||||
|
|
@ -2620,19 +2619,19 @@ msgstr ""
|
|||
#. type: Plain text
|
||||
#: docs/faq/how-to-reformat-your-usb-drive.mdx:52
|
||||
#, no-wrap
|
||||
msgid "\n"
|
||||
msgid ".png>).png>).png>)\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Plain text
|
||||
#: docs/faq/how-to-reformat-your-usb-drive.mdx:54
|
||||
#, no-wrap
|
||||
msgid "\n"
|
||||
msgid ".png>)\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Plain text
|
||||
#: docs/faq/how-to-reformat-your-usb-drive.mdx:56
|
||||
#, no-wrap
|
||||
msgid "\n"
|
||||
msgid ".png>)\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Title #
|
||||
|
|
@ -2856,7 +2855,7 @@ msgstr ""
|
|||
#. type: Plain text
|
||||
#: docs/services/file-sharing.mdx:32
|
||||
#, no-wrap
|
||||
msgid "<div><figure><img src=\"/img/docs/Screenshot_20260414-122810.png\" alt=\"\"/><figcaption></figcaption></figure> <figure><img src=\"/img/docs/Screenshot_20260414-122821.png\" alt=\"\"/><figcaption></figcaption></figure></div>\n"
|
||||
msgid "<div><figure><img src=\"/img/docs/Screenshot_20260414-122810 (1).png\" alt=\"\"/><figcaption></figcaption></figure> <figure><img src=\"/img/docs/Screenshot_20260414-122821 (1).png\" alt=\"\"/><figcaption></figcaption></figure></div>\n"
|
||||
msgstr ""
|
||||
|
||||
#. type: Plain text
|
||||
|
|
|
|||
|
|
@ -154,7 +154,7 @@ body {
|
|||
margin: 0 0 .75rem;
|
||||
}
|
||||
.butter-content .content-text {
|
||||
font-family: var(--butter-base-font);
|
||||
font-family: var(--butter-text-font);
|
||||
font-size: 20px;
|
||||
line-height: 1.6;
|
||||
color: var(--butter-black);
|
||||
|
|
|
|||
|
|
@ -19,11 +19,11 @@ function Hero() {
|
|||
alt="Butter App Feature Logo"
|
||||
/>
|
||||
<Heading as="h1" className="hero-title">
|
||||
<Translate id="home.title">Sharing offline has never been easier</Translate>
|
||||
<Translate id="home.title">Introducing Butter Box</Translate>
|
||||
</Heading>
|
||||
<p className="hero-subtitle">
|
||||
<Translate id="home.subtitle1">Power your own hotspot to share educational materials, videos and apps in small groups or classrooms.</Translate><br/>
|
||||
<Translate id="home.subtitle2">No internet required.</Translate>
|
||||
<Translate id="home.subtitle1">Life without internet made smoother.</Translate><br/>
|
||||
<Translate id="home.subtitle2">Get access to tools that help.</Translate>
|
||||
</p>
|
||||
</div>
|
||||
</header>
|
||||
|
|
|
|||
Binary file not shown.
BIN
static/img/docs/20250815_142828 (1).jpg
Normal file
BIN
static/img/docs/20250815_142828 (1).jpg
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 2.7 MiB |
BIN
static/img/docs/800x450 (1).png
Normal file
BIN
static/img/docs/800x450 (1).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 375 KiB |
BIN
static/img/docs/Screenshot 2024-04-15 at 1.05.07 PM (1).png
Normal file
BIN
static/img/docs/Screenshot 2024-04-15 at 1.05.07 PM (1).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 374 KiB |
BIN
static/img/docs/Screenshot 2025-08-05 at 2.09.49 PM (1).png
Normal file
BIN
static/img/docs/Screenshot 2025-08-05 at 2.09.49 PM (1).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 286 KiB |
BIN
static/img/docs/Screenshot 2026-02-24 at 1.28.37 PM (1).png
Normal file
BIN
static/img/docs/Screenshot 2026-02-24 at 1.28.37 PM (1).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 388 KiB |
BIN
static/img/docs/Screenshot_20260414-122810 (1).png
Normal file
BIN
static/img/docs/Screenshot_20260414-122810 (1).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 86 KiB |
BIN
static/img/docs/Screenshot_20260414-122821 (1).png
Normal file
BIN
static/img/docs/Screenshot_20260414-122821 (1).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 95 KiB |
BIN
static/img/docs/files (1).png
Normal file
BIN
static/img/docs/files (1).png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 68 KiB |
|
Before Width: | Height: | Size: 398 KiB After Width: | Height: | Size: 398 KiB |
|
Before Width: | Height: | Size: 66 KiB After Width: | Height: | Size: 66 KiB |
|
Before Width: | Height: | Size: 641 KiB After Width: | Height: | Size: 641 KiB |
|
Before Width: | Height: | Size: 173 KiB After Width: | Height: | Size: 173 KiB |
|
Before Width: | Height: | Size: 641 KiB After Width: | Height: | Size: 641 KiB |
|
Before Width: | Height: | Size: 80 KiB After Width: | Height: | Size: 80 KiB |
|
Before Width: | Height: | Size: 299 KiB After Width: | Height: | Size: 299 KiB |
|
Before Width: | Height: | Size: 77 KiB After Width: | Height: | Size: 77 KiB |
|
Before Width: | Height: | Size: 133 KiB After Width: | Height: | Size: 133 KiB |
|
Before Width: | Height: | Size: 59 KiB After Width: | Height: | Size: 59 KiB |
|
Before Width: | Height: | Size: 320 KiB After Width: | Height: | Size: 320 KiB |
|
Before Width: | Height: | Size: 183 KiB After Width: | Height: | Size: 183 KiB |
Some files were not shown because too many files have changed in this diff Show more
Loading…
Add table
Add a link
Reference in a new issue