# Jambula-OS
Jambula OS is a custom tailored Linux operating system designed for SoC devices such as the Raspberry Pi
It is mainly used by our company i.e. Jambula Labs to build smart devices such as JambulaTV,
a low cost and smart home hub that automates several tasks in your house or apartment while providing security and
privacy to you and your family. Read more about it at: https://jambulatv.com
Pre-requisites
Currently, Jambula OS (Pi Edition) is a console only platform running several open source and popular software
services. There's an initial ncurses style based setup program that allows you to configure the functions that
will be provided by your Raspberry Pi. However, in order to use it effectively, you need to already be
familiar with using Linux on the command line interface (CLI).
You will also need a Raspberry Pi 5 device with all accessories required to boot including and SD card.
Supported Boards
1. Raspberry Pi 5 Model B Rev 1.0
How to quickly get started
1. Download the latest Jambula OS image to a temporary directory:
wget -P /tmp -c https://jambula.net/downloads/Jambula-OS/jambulaOS-202501-171301-img.7z
2. Extract the above image to a temporary directory using p7zip tool (https://www.7-zip.org/download.html)
cd /tmp
7za e /tmp/jambulaOS-202410-010544-img.7z
3. Burn the resulting image i.e. sdcard.img to your SD card using a tool such as dd
For example: If your SD card is mounted at /dev/sdb enter the following command line:
dd status=progress if=/tmp/sdcard.img of=/dev/sdb
4. Insert SD card into your raspberry pi and power it on
5. During the first boot process, Jambula OS will perform an initial system
configuration and reboot automatically.
6. Upon reboot of your device, log in as root using the default password of "Jambula"
IMPORTANT: You will be prompted to change the password. Please do so immediately and
remember to use a strong password
7. After changing your password, the Jambula OS setup menu will appear as shown above.
The setup menu will allow you to configure your device according to your needs.
TIP: To run the setup menu again, use the command line tool: jambula-setup
8. Finally, if you like were this is going and are able, please support my work by
making a contribution today. Check out the FUNDING file for details. You can also
contact me via email using: joseph AT zikusooka.com
9. Enjoy!
Home-Assistant
Starting with October 2024 releases, support for Home-Assistant is included in this image.
This means you can now use the setup menu to perform local installs and setups of
Home-Assistant core. The current release includes version 2024.9.3. However, you can also
upgrade to the latest upstream versions once you are connected to the internet
TO DO
1. Raspberry Pi 4 and 3 series hardware support
2. File sharing and syncing
3. Network and device monitoring
Support Jambula OS
Your financial support can help sustain and improve Jambula OS. Please consider contributing
to this project! Ceck out the FUNDING file for details or contact me direct via email using:
joseph AT zikusooka.com