The cuddly waffle toolset for T3 Raspberry Pi image creation & maintenance.
This tool augments the Alaska T3 program and the T3 Alliance Raspberry Pi (RPi) ecosystem by providing the t3x tool to assist in creating a standardized T3 Raspberry Pi platform. The project has a few goals:
- Improve our ability to configure and harden the operating system and services used in T3 PIs.
- Ensure the ability to update and synchronize the recommended tools and configurations for T3 projects and RPi systems.
- Provide a platform for T3 RPi hackers to share and engage with neat tools and solutions to problems that evolve what we can do together.
- An interface to engaging with fun and silly things along with the serious stuff.
Note
Safe, Secure, Accessible & Fun: The core mission of this project is to provide an interface that allows T3 learners to fortify the security and configuration of their devices, protecting them from potential cyber threats. It's not just about providing technology; it's about delivering safe and secure technology. Doing this should also be fun and adaptable to the evolving needs of the T3 community and their projects.
Fully manual clone steps:
git clone git@github.com:uaf-t3/t3x
cd t3x
# Review the scripts starting with bootstrap.sh
./scripts/bootstrap.sh
Trust the T3X CHEESE lab team? Recommended easy method:
curl https://raw.githubusercontent.com/uaf-t3/t3x/main/scripts/bootstrap.sh | bash -e
.bashrcwill be setup to include.bash.d/*.shscripts.bash.d/00-t3x.shwill setup$HOME/t3x/binin userPATH.bash.d/00-local.shwill ensure$HOME/.local/binis in userPATH.bash.d/(other).shother scripts added for quality of life or when a user choosed to include/add a new feature that augments.
Beyond that the impacts of T3X will depend on what tools from it you run.
The t3x command offers an interface to a collection of scripts and tools.
t3x bootstrap or $HOME/t3x/scripts/bootstrap.sh
- Gets t3x installed & into a good state by the following steps:
- Verify functional access to the Internet
- Ensures basic tools needed for bootstrap (git) are available
- Fetches the latest version of the t3x
mainbranch. - Setup
$HOME/.bash.dfolder. - Use
.bash.d/00-t3x.shto ensure$HOME/t3x/binis in$PATH
t3x update
- Attempt to update t3x using git
t3x sanity
- Tries to ensure all the tool dependancies for t3x are done
- This is done as part of bootstrap but can be run again later to ensure any new dependancies are available.
Tools to manage our pi. Includes fun gems like:
-
t3x pi setup(TODO)-
t3x pi update -
t3x pi wallpaper
-
-
t3x pi lockdown- runs setup (and steps involved there)
-
enable-wfwinstalls and enables firewall -
ssh-disablestops and disables SSH -
password-checkverifies default password not being used -
vnc-disablestops and disables VNC
A tool to ensure our T3 RPis have a cool custom prompt and fonts for maximum enjoyment. See the tools/starship/README.md for more details.
t3x starship setup
- Installs & configures starship.sh
- Ensures the LxTerminal is using a NerdFont (required for advanced prompts)
- Future TODO include bash-completion and other advanced shells
t3x starship launch
- Bonus launch features
We want this tool to be available for T3 sites and others to use under an open-source license. We picked the Apache 2.0 license that provides the following features to users. Any contributions to this project must be eligible to be included under this license or as needed; any specific file must clearly be labeled if they fall under different licensing restrictions.
| Permissions | Conditions | Limitations |
|---|---|---|
| 🟢 Commercial Use | 🔵 License & copyright notice | 🔴 Liability |
| 🟢 Distribution | 🔵 State changes | 🔴 Trademark use |
| 🟢 Modification | 📝 | 🔴 Warranty |
| 🟢 Patent use | 📜 | |
| 🟢 Private use | 🔇 |
See the LICENSE.md file for full license.
- Seeds from the Easybotics T3 rpi config script.
- @dayne - T3X Innovation Architect
- @ItalianSquirel - T3X Code Conjurer
- @SushiFanta - T3X Algorithm Alchemist