update ru content for docs

This commit is contained in:
n8fr8 2026-04-23 18:14:14 -04:00
parent 4d106ec2b8
commit 51e98c685b
29 changed files with 494 additions and 855 deletions

View file

@ -1,8 +0,0 @@
{
"label": "Raspberry Pi",
"position": 1,
"link": {
"type": "doc",
"id": "build-a-box/raspberry-pi/index"
}
}

View file

@ -1,35 +1,36 @@
---
sidebar_position: 2
title: "Основные комплектующие"
nav_order: 1
parent: "Raspberry Pi"
grand_parent: "Сборка Butter Box"
---
# 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 **410 connected devices at once** without slowing down. Its possible to have more, but performance may drop if everyone is downloading large files or videos at the same time.
Базовая конфигурация Butter Box — это Raspberry Pi Zero 2 W с картой microSD, на которой установлено программное обеспечение Butter, USB-накопитель и питание от USB-источника, такого как блок питания, power bank или солнечная панель.
The reach for it is about **510 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.
В большинстве таких конфигураций Butter Box может комфортно обслуживать **от 4 до 10 подключённых устройств одновременно** без замедления. Возможно подключить и больше, но производительность может снизиться, если все одновременно загружают большие файлы или видео.
## Supplies
Радиус действия составляет около **510 метров** в помещении, в зависимости от модели Raspberry Pi, а также от стен и помех. На открытом воздухе, на открытом пространстве, он иногда может быть больше. Представьте себе радиус действия домашнего Wi-Fi роутера — достаточно, чтобы покрыть класс, кафе, переговорную комнату или небольшое мероприятие на открытом воздухе.
* [ ] 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>
* [ ] 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.md)
* [ ] Карта Micro SD: Образы с программным обеспечением Butter обычно занимают менее 16 ГБ (мы рекомендуем 256 ГБ). Медиафайлы, которые люди загружают в чат, сохраняются на карте; они никогда не удаляются.
* [ ] USB-накопитель (минимум 32 ГБ)
* [ ] Адаптеры (по необходимости)
* [ ] Micro USB/штекер на USB A/гнездо
* [ ] Переходник для подключения карты micro SD к вашему ноутбуку (если необходимо)
**Когда у вас будут все комплектующие, переходите к разделу «Установка Butter».**
[install-butter.md](install-butter.md)
![](../../assets/images/20250815_142828.jpg)

View file

@ -1,49 +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"
---
# Extend Your Box
# Апгрейд Butter Box
An extended Butter Box pairs the Raspberry Pi with a standalone Wi-Fi router, giving stronger signal and more simultaneous connections.
Butter Box с увеличенным радиусом действия объединяет Raspberry Pi с отдельным Wi-Fi маршрутизатором, обеспечивая более сильный сигнал и большее количество одновременных подключений.
With the router, the network can reach 10-30 m (32-98 feet),and can comfortably support 1020 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 м и комфортно поддерживать 1020 подключённых устройств одновременно. Эта конфигурация идеально подходит для средней группы людей в помещении среднего размера, например, в учебных классах, на мероприятиях или в общественных пространствах.
## 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)
* [ ] 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.md)
* [ ] Карта Micro SD: образы с программным обеспечением Butter обычно занимают менее 16 ГБ (мы рекомендуем Micro SD карту 256 ГБ). Медиафайлы, которые пользователи загружают в чат, сохраняются на карте и никогда не удаляются.
* [ ] USB-накопитель (минимум 32 ГБ)
* [ ] Адаптеры (при необходимости)
_No internet connection is required._
_Подключение к интернету не требуется._
<figure><img src="/img/docs/20250815_142438.jpg" alt=""/><figcaption></figcaption></figure>
![](../../assets/images/20250815_142438.jpg)
## Шаги
## Steps
Чтобы увиличить радиус действия вашего Butter Box, просто подключите маршрутизатор GLi-Net к Butter Box с помощью кабеля Ethernet. Вместо доступа к коробке через портальную точку доступа Wi-Fi (например, butter box или любое имя, которое вы задали в настройках администратора), пользователи будут подключаться к сети Wi-Fi маршрутизатора.
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.
### Подключите Butter Box к источнику питания.
Connect the Butter Box to power.
Подключите Butter Box к питанию.
### 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.
Подключите маршрутизатор к питанию. Затем используйте кабель Ethernet для подключения к Butter Box. Убедитесь, что кабель Ethernet подключён к порту LAN на вашем маршрутизаторе.
### 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 dont get confused about which network to join.
### Invite Users to Join the Router Wi-Fi
### Проверьте подключение
Подключитесь к Wi-Fi маршрутизатора. Если вы ещё не настраивали и не использовали этот маршрутизатор, введите пароль по умолчанию, указанный в руководстве пользователя, входящем в комплект. Через 30 секунд откройте http://butterbox.local в браузере.
---
### Отключите точку доступа Wi-Fi Butter Box
Откройте настройки администратора на портале Butter Box. Перейдите в раздел **Безопасный портал**. Отключите точку доступа Wi-Fi. Это скроет сеть Wi-Fi, транслируемую Raspberry Pi, чтобы пользователи не путались, к какой сети подключаться.
---
### Пригласите пользователей подключиться к Wi-Fi маршрутизатора
Теперь пользователи будут подключаться к сети Wi-Fi маршрутизатора, когда захотят подключиться к Butter Box.
Users will now join the Wi-Fi network of the router when they want to connect to the Butter Box.

View file

@ -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

View file

@ -1,88 +1,112 @@
---
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"
---
# Install Butter
# Установка 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.
### Скачайте 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
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.27AM.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.31AM.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.37PM.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.43PM.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)
---
### Вставьте карту micro SD в компьютер
### Troubleshooting
Чтобы вставить карту micro SD в компьютер, вам может понадобиться адаптер:
If you see an error stating that the input file is not a valid disk image, check the file you downloaded.
![Пример адаптера (USB-C к Micro SD)](../../assets/images/image.png)
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.
---
### Запустите Raspberry Pi Imager
После того как вы вставили карту micro SD в компьютер с подключением к интернету, запустите Raspberry Pi Imager на настольном компьютере. Программа проведёт вас через шаги установки операционной системы Butter на карту micro SD.
Если у вас нет Raspberry Pi Imager, вы можете скачать его здесь: [https://www.raspberrypi.com/software/](https://www.raspberrypi.com/software/)
---
### Выберите устройство > **Raspberry Pi Zero 2 W**
После запуска Raspberry Pi Imager вам будет предложено выбрать устройство Raspberry Pi.
<img src="../../.gitbook/assets/Screenshot 2026-02-24 at 9.56.27AM.png" alt=""/>
<p>Выберите Raspberry Pi Zero 2 W (или другое устройство, если у вас не стандартная коробка от Butter HQ)</p>
---
### Выберите операционную систему > Use Custom
* На вкладке ОС выберите **Use Custom** и загрузите файл butter-******.img Убедитесь, что вы **распаковали файл xz** перед использованием.
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 9.57.31AM.png" alt=""/><figcaption><p>Выберите «Use Custom». Выберите файл .img, который скачали с Dropbox.</p></figcaption></figure>
---
### Выберите хранилище > Выберите карту Micro SD
* На вкладке **Хранилище** выберите **карту Micro SD.**
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.27.37PM.png" alt=""/><figcaption><p>Выберите карту Micro SD.</p></figcaption></figure>
После того как вы всё выбрали, ваш экран будет выглядеть примерно так:
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.27.43PM.png" alt=""/><figcaption><p>Финальный экран после выбора.</p></figcaption></figure>
Вам может быть показано сообщение _«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), который не подключён к питанию.
---
### Перейдите к быстрому старту
Подключите Raspberry Pi (Butter Box) к питанию. Подождите несколько мгновений и подключитесь к порталу Butter Box. Перейдите в раздел [Быстрый старт](../../quick-start.md) для получения дополнительной информации.
---
**Если вы собираете улучшенный Butter Box (с увеличенным радиусом действия), перейдите к следующему разделу: Апгрейд Butter Box.**
[extend-your-box.md](extend-your-box.md)
### Устранение неполадок
Если вы видите ошибку, указывающую, что входной файл не является допустимым образом диска, проверьте скачанный файл.
Убедитесь, что размер файла совпадает с размером, указанным на сайте. Иногда браузеры не завершают загрузку, что может привести к повреждению файла.
Также убедитесь, что вы **распаковали файл** перед использованием.
<figure><img src="../../.gitbook/assets/Screenshot 2026-02-24 at 1.28.37PM.png" alt=""/><figcaption></figcaption></figure>
<figure><img src="/img/docs/Screenshot 2026-02-24 at 1.28.37PM.png" alt=""/><figcaption></figcaption></figure>

View file

@ -1,15 +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>