Skip to content

Commit cbcc1ff

Browse files
authored
docs: remove falsehoods, add graph and description (#20)
Co-authored-by: ER <[email protected]>
1 parent 7e3c54a commit cbcc1ff

File tree

2 files changed

+9
-57
lines changed

2 files changed

+9
-57
lines changed

README.md

+9-57
Original file line numberDiff line numberDiff line change
@@ -1,80 +1,32 @@
1-
# base
1+
# Main
22

33
[![build-ublue](https://github.com/ublue-os/main/actions/workflows/build.yml/badge.svg)](https://github.com/ublue-os/main/actions/workflows/build.yml)
44

5-
A base image with a (mostly) stock Fedora Silverblue. Help us make a sweet base image: Pull requests and improvements appreciated and encouraged! Scroll to the bottom to see how to make your own!
5+
A WIP common main image for all other Ublue images.
66

77
## What is this?
88

9-
This is a base Fedora Silverblue image designed to be customized to whatever you want, have GitHub build it for you, and then host it for you. You then just tell your computer to boot off of that image. GitHub keeps 90 days worth image backups for you, thanks Microsoft!
9+
This is an upstream image for all of the other Ublue images to inherit from. This image contains common packages for different editions and is inteded for further customization by downstream images.
1010

11-
Check out the [spec for Fedora](https://fedoraproject.org/wiki/Changes/OstreeNativeContainerStable) for more information and proper explanation.
12-
13-
Check out our [organization page](https://github.com/ublue-os) for images with MATE, XFCE, and an Ubuntu-like flavor. Or go right to the [Nvidia image](https://github.com/ublue-os/nvidia), your pathway to a more reliable experience. Some of these are examples that build off of this base image, so build whatever you'd like!
14-
15-
These github actions and methods are meant to be shared and improved upon, [so come on in](https://github.com/orgs/ublue-os/discussions) and help out!
16-
17-
## Usage
18-
19-
> **Warning**
20-
> This is an experimental feature and should not be used in production, try it in a VM for a while! If you are rebasing and not doing a clean install do a `touch ~/.config/ublue/firstboot-done` to keep your flatpak configuration untouched BEFORE you rebase, otherwise we're going to mangle it (for science).
21-
22-
To rebase an existing Silverblue/Kinoite machine to the latest release (37):
23-
24-
sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/base:37
25-
26-
We build date tags as well, so if you want to rebase to a particular day's release:
27-
28-
sudo rpm-ostree rebase ostree-unverified-registry:ghcr.io/ublue-os/base:20221217
29-
30-
The `latest` tag will automatically point to the latest build. Note that when a new version of Fedora is released that the `latest` tag will get updated to that latest release automatically.
11+
Graph of the Ublue structure:
12+
![Graph of the Ublue structure. Fedora-built images on the top, and only the opionated main aka this image inherits from it. Users is on the bottom, and users get the Ublue main image, a hypothetical image intended for Amd gpus and another existing one for Nvidia gpus. A startingpoint image inherits from the main, Amd and Nvidia images, and it is inteded for further customization by tinkerers into community-built images.](ublue-structure-graph.png)
3113

3214
## Features
3315

34-
- Start with a base Fedora Silverblue 37 image
35-
- Removes Firefox from the base image
36-
- Adds the following packages to the base image:
37-
- distrobox and gnome-tweaks
38-
- Sets automatic staging of updates for the system
39-
- Sets flatpaks to update twice a day
40-
- Everything else (desktop, artwork, etc) remains stock so you can use this as a good starting image
16+
TBA
4117

4218
## Applications
4319

44-
- All applications installed per user instead of system wide, similar to openSUSE MicroOS, they are not on the base image. Thanks for the inspiration Team Green!
45-
- Mozilla Firefox, Mozilla Thunderbird, Extension Manager, Libreoffice, DejaDup, FontDownloader, Flatseal, and the Celluloid Media Player
46-
- Core GNOME Applications installed from Flathub
47-
- GNOME Calculator, Calendar, Characters, Connections, Contacts, Evince, Firmware, Logs, Maps, NautilusPreviewer, TextEditor, Weather, baobab, clocks, eog, and font-viewer
48-
49-
## Further Customization
50-
51-
The `just` task runner is included for further customization after first boot.
52-
It will copy the template from `/etc/justfile` to your home directory.
53-
After that run the following commands:
20+
TBA
5421

55-
- `just` - Show all tasks, more will be added in the future
56-
- `just bios` - Reboot into the system bios (Useful for dualbooting)
57-
- `just changelogs` - Show the changelogs of the pending update
58-
- Set up distroboxes for the following images:
59-
- `just distrobox-boxkit`
60-
- `just distrobox-debian`
61-
- `just distrobox-opensuse`
62-
- `just distrobox-ubuntu`
63-
- `just setup-flatpaks` - Install a selection of flatpaks, use this section to add your own apps
64-
- `just setup-gaming` - Install Steam, Heroic Game Launcher, OBS Studio, Discord, Boatswain, Bottles, and ProtonUp-Qt. MangoHud is installed and enabled by default, hit right Shift-F12 to toggle
65-
- `just update` - Update rpm-ostree, flatpaks, and distroboxes in one command
66-
67-
Check the [just website](https://just.systems) for tips on modifying and adding your own recipes.
68-
69-
7022
## Verification
7123

7224
These images are signed with sisgstore's [cosign](https://docs.sigstore.dev/cosign/overview/). You can verify the signature by downloading the `cosign.pub` key from this repo and running the following command:
7325

7426
cosign verify --key cosign.pub ghcr.io/ublue-os/base
75-
27+
7628
If you're forking this repo you should [read the docs](https://docs.github.com/en/actions/security-guides/encrypted-secrets) on keeping secrets in github. You need to [generate a new keypair](https://docs.sigstore.dev/cosign/overview/) with cosign. The public key can be in your public repo (your users need it to check the signatures), and you can paste the private key in Settings -> Secrets -> Actions.
7729

7830
## Making your own
7931

80-
See [the documentation](https://ublue.it/making-your-own/) on how to clone and use this repo for your own projects.
32+
See [the documentation](https://ublue.it/making-your-own/) on how use this image in your own projects.

ublue-structure-graph.png

52 KB
Loading

0 commit comments

Comments
 (0)