Bump version to 2025.12.0
62
README.md
|
|
@ -1,12 +1,14 @@
|
||||||
")
|

|
||||||
# Jambula-OS
|
|
||||||
|
|
||||||
Jambula OS is a custom tailored Linux operating system designed for ARM-based System-on-Chip (SoC) devices such as those found in single board computers (SBCs) like the Raspberry Pi.
|
Jambula OS is a lightweight, free, and open source Linux operating system customized for deployment on embedded single board computers (SBCs), such as the popular Raspberry Pi.
|
||||||
|
|
||||||
|
This stable and efficient distribution is the ideal foundation for tech enthusiasts, developers, and the DIY/maker community especially those in the smart home space.
|
||||||
|
|
||||||
It is mainly used by our organization i.e. Jambula Labs to build smart devices such as JambulaTV,
|
Designed for maximum resilience in internet or power challenged areas, Jambula OS prioritizes a 'local-first' architecture ensuring your projects and data remain reliable, even when the connection goes offline.
|
||||||
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
|
It is designed for low resource hardware and provides out-of-the-box support for essential features like Wi-Fi hotspot networking and a file sharing collaboration platform.
|
||||||
|
|
||||||
|
Read more about it at: https://jambula.org
|
||||||
|
|
||||||
|
|
||||||
<b>Pre-requisites</b>
|
<b>Pre-requisites</b>
|
||||||
|
|
@ -23,20 +25,19 @@ You will also need a Raspberry Pi 5 device with all accessories required to boot
|
||||||
|
|
||||||
1. Raspberry Pi 5 Model B Rev 1.0
|
1. Raspberry Pi 5 Model B Rev 1.0
|
||||||
|
|
||||||
|

|
||||||

|
|
||||||
|
|
||||||
<b> How to quickly get started </b>
|
<b> How to quickly get started </b>
|
||||||
|
|
||||||
1. Download the latest Jambula OS image to a temporary directory:
|
1. Download the latest Jambula OS image to a temporary directory:
|
||||||
|
|
||||||
wget -P /tmp -c https://jambula.net/downloads/Jambula-OS/jambulaOS-202509-100303-img.7z
|
wget -P /tmp -c https://jambula.net/downloads/Jambula-OS/jambulaOS-202512-092314-img.7z
|
||||||
|
|
||||||
2. Extract the above image to a temporary directory using p7zip tool (https://www.7-zip.org/download.html)
|
2. Extract the above image to a temporary directory using p7zip tool (https://www.7-zip.org/download.html)
|
||||||
|
|
||||||
cd /tmp
|
cd /tmp
|
||||||
|
|
||||||
7za e /tmp/jambulaOS-202509-100303-img.7z
|
7za e /tmp/jambulaOS-202512-092314-img.7z
|
||||||
|
|
||||||
3. Burn the resulting image i.e. sdcard.img to your SD card using a tool such as dd
|
3. Burn the resulting image i.e. sdcard.img to your SD card using a tool such as dd
|
||||||
|
|
||||||
|
|
@ -46,24 +47,27 @@ You will also need a Raspberry Pi 5 device with all accessories required to boot
|
||||||
|
|
||||||
4. Insert SD card into your raspberry pi and power it on
|
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
|
5. Upon initial boot, Jambula OS will present crucial setup information on the Linux
|
||||||
configuration and reboot automatically.
|
console, including details for connecting to the temporary Wi-Fi hotspot and the
|
||||||
|
necessary SSH connection command
|
||||||
|
|
||||||
6. Upon reboot of your device, log in as root using the temporary password printed out.
|
6. After establishing the remote SSH connection, you will be automatically presented
|
||||||
IMPORTANT: You will be prompted to change the password. Please do so immediately and
|
with a setup wizard to begin configuring Jambula OS.
|
||||||
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.
|
|
||||||
|
7. Once you successfully navigate the simple setup wizard, the system will perform an
|
||||||
|
automatic reboot, and Jambula OS will be fully configured and ready for use.
|
||||||
TIP: To run the setup menu again, use the command line tool: jambula-setup
|
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
|
8. Feel free to contribute to Jambula OS by filing detailed bug reports and submitting
|
||||||
|
code enhancements via Pull Requests directly to our Git repository.
|
||||||
|
|
||||||
|
9. 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
|
making a contribution today. Check out the FUNDING file for details. You can also
|
||||||
contact me via email using: joseph AT zikusooka.com
|
contact me via email using: zik AT jambula.org
|
||||||
|
|
||||||
9. Enjoy!
|
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
|
|
@ -71,23 +75,21 @@ You will also need a Raspberry Pi 5 device with all accessories required to boot
|
||||||
|
|
||||||
Starting with October 2024 releases, support for Home-Assistant is included in this image.
|
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 upgrades of
|
This means you can now use the setup menu to perform local installs and upgrades of
|
||||||
Home-Assistant core. The current release includes version 2025.9.0. However, you can also
|
Home-Assistant core. The current release includes version 2025.12.0. However, you can also
|
||||||
upgrade to the latest upstream versions once you are connected to the internet
|
upgrade to the latest upstream versions once you are connected to the internet.
|
||||||
|
|
||||||
|
|
||||||
|
|
||||||
<b>TO DO</b>
|
<b>TO DO</b>
|
||||||
|
|
||||||
1. Raspberry Pi 4 and 3 series hardware support
|
1. Raspberry Pi 4 and 3 series hardware support
|
||||||
|
|
||||||
2. File sharing and syncing
|
2. Photo management
|
||||||
|
|
||||||
3. Network and device monitoring
|
3. Network and device monitoring
|
||||||
|
|
||||||
|
|
||||||
<b>Support Jambula OS</b>
|
<b>IMPORTANT: Support Jambula OS</b>
|
||||||
|
|
||||||
Your financial support can help sustain and improve Jambula OS. Please consider contributing
|
Your financial support can help sustain and improve Jambula OS. Please consider contributing
|
||||||
to this project! Check out the FUNDING file for details or contact me direct via email using:
|
to this project! Check out the FUNDING file for details or contact me direct via email using:
|
||||||
joseph AT zikusooka.com
|
zik AT jambula.org
|
||||||
|
|
||||||
|
|
|
||||||
BIN
console.png
|
Before Width: | Height: | Size: 173 KiB |
|
After Width: | Height: | Size: 9.3 MiB |
|
After Width: | Height: | Size: 148 KiB |
|
After Width: | Height: | Size: 190 KiB |
|
After Width: | Height: | Size: 327 KiB |
|
After Width: | Height: | Size: 298 KiB |
|
After Width: | Height: | Size: 21 KiB |
|
Before Width: | Height: | Size: 84 KiB |