README.md

Silverblue Cloud OS

This image is currently based on ublue-os/silverblue-main:39.

Table of contents

• Installation
• GUI Tools
• CLI Tools
• Tips
  • Neovim
  • Flameshot
  • Oh my zsh
  • eza
  • bat
  • starship
  • Alacritty
  • lazygit
  • zellij
• Screenshots

Installation

To rebase an existing atomic Fedora installation to the latest build:

• First rebase to the unsigned image, to get the proper signing keys and policies installed.

  rpm-ostree rebase ostree-unverified-registry:ghcr.io/kerwood/cloud-os:latest
  

• Reboot to complete the rebase.

  systemctl reboot
  

• Then rebase to the signed image.

  rpm-ostree rebase ostree-image-signed:docker://ghcr.io/kerwood/cloud-os:latest
  

• Reboot again to complete the installation.

  systemctl reboot
  

The latest tag will automatically point to the latest build. That build will still always use the Fedora version specified in recipe.yml, so you won't get accidentally updated to the next major version.

GUI Tools

• Alacritty - A fast, cross-platform, OpenGL terminal emulator.
  • https://github.com/alacritty/alacritty
• AppImageLauncher - Integrate AppImages into your application launcher with one click
  • https://github.com/TheAssassin/AppImageLauncher
• Discord - An instant messaging and VoIP social platform which allows communication through voice calls, video calls, text messaging, and media and files.
  • https://discord.com/
• Flameshot - Powerful, yet simple to use open-source screenshot software.
  • https://flameshot.org
• JetBrains Toolbox - Manage your JetBrains IDEs the easy way.
  • https://www.jetbrains.com/toolbox-app
• Spotify - A digital music service that gives you access to millions of songs.
  • https://spotify.com
• Ulauncher - Application launcher for Linux.
  • https://ulauncher.io
• Visual Studio Code - Code editor.
  • https://code.visualstudio.com
• Wireshark - Free and open-source packet analyzer.
  • https://www.wireshark.org
• Papirus Icon Theme - Free and open source SVG icon theme for Linux
  • https://github.com/PapirusDevelopmentTeam/papirus-icon-theme

CLI Tools

• argocd-cli - CLI Tool for managing ArgoCD.
  • https://argo-cd.readthedocs.io/en/stable/cli_installation
• azure-cli - Azure Cloud commandline tool.
  • https://learn.microsoft.com/en-us/cli/azure
• bat - Modern cat replacement.
  • https://github.com/sharkdp/bat
• bombardier - HTTP(S) benchmarking tool.
  • https://github.com/codesenberg/bombardier
• btop - Resource monitor.
  • https://github.com/aristocratos/btop
• caddy - Caddy is an extensible web server platform that uses TLS by default.
  • https://github.com/caddyserver/caddy
• distrobox - Use any Linux distribution inside your terminal.
  • https://distrobox.it
• dive - A tool for exploring a docker image and its layer contents.
  • https://github.com/wagoodman/dive
• docker - Container runtime.
  • https://www.docker.com
• duf - Disk Usage/Free Utility.
  • https://github.com/muesli/duf
• eza - Modern ls replacement.
  • https://github.com/eza-community/eza
• fzf - General-purpose command-line fuzzy finder.
  • https://github.com/junegunn/fzf
• git - Version control system.
  • https://git-scm.com
• git-delta - A syntax-highlighting pager for git, diff, and grep output.
  • https://github.com/dandavison/delta
• google-cloud-cli - Google Cloud commandline tool.
  • https://cloud.google.com/sdk/gcloud
• gum - A tool for glamorous shell scripts.
  • https://github.com/charmbracelet/gum
• helm - Manage, template or install Helm packages.
  • https://github.com/helm/helm
• httpie - Modern curl replacement.
  • https://httpie.io/cli
• just - Command runner with improvements over "make".
  • https://github.com/casey/just
• jq - Slice, filter, map and transform JSON data with ease.
  • https://jqlang.github.io/jq
• k9s - Terminal UI to interact with your Kubernetes clusters.
  • https://github.com/derailed/K9s
• kind - A tool for running local Kubernetes clusters using Docker container “nodes”.
  • https://github.com/kubernetes-sigs/kind
• krew - Plugin manager for the kubectl command-line tool.
  • https://github.com/kubernetes-sigs/krew
• kubectl - Tool for communicating with Kubernetes control plane
  • https://kubernetes.io/docs/reference/kubectl
• kubectx/kubens - Switch between Kubenetes contexts or namespaces with ease.
  • https://github.com/ahmetb/kubectx
• lazydocker - A simple terminal UI for both docker and docker-compose
  • https://github.com/jesseduffield/lazydocker
• lazygit - A simple terminal UI for git commands.
  • https://github.com/jesseduffield/lazygit
• mirrord - Run local processes in the context of their Kubernetes environment.
  • https://github.com/metalbear-co/mirrord
• neovim - Terminal based code editor.
  • https://neovim.io
• ncdu - Review files and the disk space being used on Linux systems.
• paping - TCP port testing, emulating the functionality of ping (port ping)
  • https://code.google.com/archive/p/paping/
• ripgrep - Alternative grep replacement.
  • https://github.com/BurntSushi/ripgrep
• ShellCheck - A static analysis tool for shell scripts.
  • https://www.shellcheck.net/
• sshfs - SSHFS allows you to mount a remote filesystem using SFTP
  • https://linux.die.net/man/1/sshfs
• sshs - Terminal user interface for SSH which uses ~/.ssh/config to list and connect to hosts.
  • https://github.com/quantumsheep/sshs
• sslscan - Queries SSL services in order to determine the ciphers that are supported.
  • https://github.com/rbsec/sslscan
• starship - The minimal, blazing-fast, and infinitely customizable prompt for any shell.
  • https://github.com/starship/starship
• stern - Tail multiple pods on Kubernetes and multiple containers within the pod.
  • https://github.com/stern/stern
• stow - Symlink farm manager.
  • https://www.gnu.org/software/stow/manual/stow.html
• syft - Generate Software Bill of Materials (SBOM) from container images and filesystems.
  • https://github.com/anchore/syft
• tailscale - Zero config VPN for building secure networks.
  • https://tailscale.com/
• terraform - Automate infrastructure on any cloud with Terraform
  • https://www.terraform.io/
• tlrc - A tldr client written in Rust
  • https://github.com/tldr-pages/tlrc
• trivy - Comprehensive and versatile security scanner.
  • https://github.com/aquasecurity/trivy
• zellij - Modern terminal multiplexer (like tmux).
  • https://github.com/zellij-org/zellij
• zoxide - Smarter cd command, inspired by z and autojump.
  • https://github.com/ajeetdsouza/zoxide
• zsh - A superior shell for your terminal needs. Unlock super powers by setting up Oh-my-zsh.

Tips

Neovim

This image comes with barebone neovim. To unlock it's full potential install NVChad. It is very easy to install, stable and comes prepacked with a handful of usefull plugins.

https://nvchad.com/

Flameshot

A keybinding (Alt + p) is already preconfigured with this image, so below information is only needed if you want to change it.

As for the time of writing, if you are using Wayland (default) you will probably have some dbus permission issues as described here, a workaround is to launch flameshot from a shell script which is included in the image.

tldr; If you are using Wayland, set this path in your keybinding: /usr/flameshot/flameshot.sh

Ulauncher

A keybinding (Ctrl + space) is already preconfigured with this image, so below information is only needed if you want to change it. If you are using Ulauncher in Wayland you should set the keybinding manual as Ulauncher does not receive hotkey events when triggered from some windows (like terminal or OS Settings).

Oh My Zsh

This images comes with the zsh. To unlock it's full potential setup Oh My Zsh, its very easy.

Change your default shell to zsh.

chsh -s /usr/bin/zsh <user-name>

Go to https://ohmyz.sh/#install and install it with one command.

eza

eza is a dropin ls replacement. Here's a few aliases you can use to replace ls.

alias ls="eza"
alias ll="eza --icons --git --header --group-directories-first -l"
alias l="eza --icons --git --header --group-directories-first -l"

bat

bat is a dropin replacement for cat. Here's an alias that replaces cat, but without line numbers. This way you get cat with syntax highlighting and git support.

alias cat='bat -p'

starship

A base configuration for starship can be found at /usr/dotfiles/starship.toml.

cp /usr/dotfiles/starship.toml ~/.config

Alacritty

A base configuration for alacritty can be found at /usr/dotfiles/alacritty.

cp -a /usr/dotfiles/alacritty ~/.config

lazygit

A base configuration for lazygit can be found at /usr/dotfiles/lazygit.

cp -a /usr/dotfiles/lazygit ~/.config

zellij

A base configuration for zellij can be found at /usr/dotfiles/zellij.

cp -a /usr/dotfiles/zellij ~/.config