89 lines
3 KiB
Text
89 lines
3 KiB
Text
|
---
|
|||
|
|
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.
|
|||
|
|
:::
|