Device Specific Notes
A Raspberry Pi is suitable for running Tronbit, as long as it has sufficient RAM. Check which device you have on the Raspberry Pi product series page and ensure you have > 512MB of memory, such as 1gb. 512 gb may be suitable with some additional configuration. A 64 bit OS is highly recommended.
If you are starting fresh, use the Raspberry Pi imager to install the Raspberry Pi OS 964-bit) onto an SD card. Be sure to apply OS customization settings to allow your Pi to connect to WiFi, and note the hostname, username and password set.
After putting the SD card into the Pi and booting it, you can connect to the Pi remotely via SSH.
In Windows 10/11, MacOS and Linux, this functionality is built in.
Otherwise, you will need to install 3rd party software like PuTTY.
Open a command prompt and type:
ssh username@hostname followed by the password, where username hostname and the password are all the items you configured during the pi setup.
On your Pi, type or copy/paste the following commands:
sudo apt update
sudo apt upgrade -y
This will check for and install updates for existing packages
curl -sSL https://get.docker.com | sh
This will install Docker using the official Docker script
Replace your_username with the username being used on the Pi before running:
sudo usermod -aG docker your_username
This will allow you to run Docker commands without re-entering your password every time.
This is an optional but reccomended step.
If you run it, log out (type exit) and log back in.
Test the install by running
docker run hello-world
If you see a message indicating Docker is up and running, you can follow the instructions on the Server readme
You can obtain a TronByt device in order to display images from the Tronbyt server.
The firmware has a rudimentary wifi config portal page that can be accessed by joining the TRONBYT-CONFIG network and navigating to http://10.10.0.1
WiFi Config Portal How-To Video
If you are trying to flash new firmware to your Tidbyt Gen1 device and the flashing console shows an error like:
Unexpected error: ESP is not in flash boot mode. If your board has a flashing pin, try again while keeping it pressed.
Failed to connect to Espressif device: Wrong boot mode detected (0x13)! The chip needs to be in download mode.
This is a known issue with some Tidbyts, possibly due to 'factory second' status.
There are two possible resolutions:
- Use a USB-A to USB-C cable instead of a USB-C to USB-C cable, especially through a USB hub. Also try using a different USB cable or different ports on your PC.
- You can also open the Tidbyt and use tweezers to ground the pin on the chip indicated here:
You can configure a liveness probe for Kubernetes by sending an HTTP request to /health
livenessProbe:
failureThreshold: 10000
httpGet:
path: /health
port: 8000