Skip to content

Commit 8d98c5e

Browse files
hanthorhanthor
authored
Merge pull request #2 from tuna-os/copilot/fix-1
Setup initial documentation site for TunaOS
2 parents a05763e + 948b5e0 commit 8d98c5e

File tree

19 files changed

+1021
-196
lines changed

19 files changed

+1021
-196
lines changed

‎docs/albacore.md‎

Lines changed: 73 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,73 @@
1+
---
2+
sidebar_position: 2
3+
---
4+
5+
# Albacore (AlmaLinux)
6+
7+
**Based on:** [AlmaLinux 10.0](https://almalinux.org/blog/2025-05-27-welcoming-almalinux-10/)
8+
9+
Stable enterprise-grade desktop experience built on AlmaLinux foundation.
10+
11+
## Features
12+
13+
- ✨ **x86_64/v2** microarchitecture support for older CPUs (pre-2013)
14+
- 🖥️ **SPICE support** for qemu/libvirt virtualization
15+
- 🏢 **Enterprise Linux** foundation with AlmaLinux reliability
16+
17+
## Downloads
18+
19+
### Regular Edition
20+
**Image:** `ghcr.io/tuna-os/albacore:latest`
21+
22+
**ISOs:**
23+
- [x86_64](https://download.tunaos.org/albacore-amd64.iso)
24+
- [x86_64_v2](https://download.tunaos.org/albacore-amd64-v2.iso)
25+
- [arm64](https://download.tunaos.org/albacore-arm64.iso)
26+
27+
### DX (Developer Experience)
28+
**Image:** `ghcr.io/tuna-os/albacore-dx:latest`
29+
30+
**ISOs:**
31+
- [x86_64](https://download.tunaos.org/albacore-dx-amd64.iso)
32+
- [x86_64_v2](https://download.tunaos.org/albacore-dx-amd64-v2.iso)
33+
- [arm64](https://download.tunaos.org/albacore-dx-arm64.iso)
34+
35+
### GDX (Graphical Developer Experience)
36+
**Image:** `ghcr.io/tuna-os/albacore-gdx:latest`
37+
38+
**ISOs:**
39+
- [x86_64](https://download.tunaos.org/albacore-gdx-amd64.iso)
40+
- [x86_64_v2](https://download.tunaos.org/albacore-gdx-amd64-v2.iso)
41+
- [arm64](https://download.tunaos.org/albacore-gdx-arm64.iso)
42+
43+
## Installation
44+
45+
### Using Container Image
46+
```bash
47+
podman pull ghcr.io/tuna-os/albacore:latest
48+
```
49+
50+
### Building ISO
51+
```bash
52+
curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
53+
-o build-bootc.sh
54+
chmod +x build-bootc.sh
55+
56+
# Build Albacore ISO
57+
sudo ./build-bootc.sh iso ghcr.io/tuna-os/albacore:latest
58+
```
59+
60+
## Differences from Project Bluefin
61+
62+
For general functionality, refer to the [Project Bluefin Documentation](https://docs.projectbluefin.io).
63+
64+
AlmaLinux-specific differences:
65+
- Based on AlmaLinux 10 instead of CentOS Stream
66+
- Enterprise Linux package ecosystem
67+
- For AlmaLinux-specific features, see [AlmaLinux Wiki](https://wiki.almalinux.org)
68+
69+
## Community Support
70+
71+
- **AlmaLinux**: [AlmaLinux Atomic SIG](https://chat.almalinux.org/almalinux/channels/sigatomic)
72+
- **Universal Blue**: [Discord Community](https://discord.gg/WEu6BdFEtp)
73+
- **TunaOS**: [Matrix Chat](https://matrix.to/#/%23tunaos:reilly.asia)

‎docs/bonito.md‎

Lines changed: 66 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,66 @@
1+
---
2+
sidebar_position: 4
3+
---
4+
5+
# Bonito (Fedora)
6+
7+
**Based on:** Fedora 42
8+
9+
Cutting-edge experience with Bluefin LTS tooling ported to the latest Fedora release.
10+
11+
:::note Development Status
12+
Bonito is still needing some work to get into a functional state. Check the [GitHub repository](https://github.com/tuna-os/tunaOS) for current progress.
13+
:::
14+
15+
## Features
16+
17+
- 🚀 **Latest Fedora** with cutting-edge packages
18+
- 🔄 **Bluefin LTS tooling** ported to modern Fedora
19+
- ⚡ **Pure bootc** implementation (unlike upstream Bluefin)
20+
21+
## Downloads
22+
23+
### Regular Edition
24+
**Image:** `ghcr.io/tuna-os/bonito:latest`
25+
26+
**ISOs:** *Coming soon - check back for updates*
27+
28+
## Installation
29+
30+
### Using Container Image
31+
```bash
32+
podman pull ghcr.io/tuna-os/bonito:latest
33+
```
34+
35+
### Building ISO
36+
```bash
37+
curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
38+
-o build-bootc.sh
39+
chmod +x build-bootc.sh
40+
41+
# Build Bonito ISO (when available)
42+
sudo ./build-bootc.sh iso ghcr.io/tuna-os/bonito:latest
43+
```
44+
45+
## Differences from Project Bluefin
46+
47+
Bonito represents an experimental approach:
48+
49+
- **Pure bootc**: Unlike upstream Bluefin which uses ostree, Bonito is built entirely on bootc
50+
- **Fedora 42 base**: Latest and greatest Fedora packages
51+
- **Modern toolchain**: Cutting-edge development environment
52+
53+
For general Bluefin functionality, refer to the [Project Bluefin Documentation](https://docs.projectbluefin.io).
54+
55+
## Development Status
56+
57+
This variant is under active development. Contributions welcome! Track progress:
58+
59+
- **Issues**: [GitHub Issues](https://github.com/tuna-os/tunaOS/issues)
60+
- **Source**: [GitHub Repository](https://github.com/tuna-os/tunaOS)
61+
62+
## Community Support
63+
64+
- **Fedora**: [Fedora Discussion](https://discussion.fedoraproject.org/)
65+
- **Universal Blue**: [Discord Community](https://discord.gg/WEu6BdFEtp)
66+
- **TunaOS**: [Matrix Chat](https://matrix.to/#/%23tunaos:reilly.asia)

‎docs/installation.md‎

Lines changed: 111 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,111 @@
1+
---
2+
sidebar_position: 6
3+
---
4+
5+
# Installation Guide
6+
7+
TunaOS images can be installed in several ways, depending on your needs and preferences.
8+
9+
## System Requirements
10+
11+
| Component | Minimum | Recommended |
12+
|-----------|---------|-------------|
13+
| **CPU** | x86_64, ARM64 | x86_64, ARM64 |
14+
| **RAM** | 4 GB | 8 GB+ |
15+
| **Storage** | 20 GB | 50 GB+ |
16+
17+
### Architecture Support
18+
19+
- **x86_64**: Standard 64-bit Intel/AMD processors
20+
- **x86_64_v2**: Optimized for older CPUs (pre-2013) - available for Albacore and Yellowfin
21+
- **ARM64**: 64-bit ARM processors (Apple Silicon, Raspberry Pi 4+, etc.)
22+
23+
## Installation Methods
24+
25+
### Method 1: Download Pre-built ISOs
26+
27+
The easiest way to get started is downloading pre-built ISO images:
28+
29+
#### Albacore (AlmaLinux 10)
30+
- [x86_64](https://download.tunaos.org/albacore-amd64.iso) | [x86_64_v2](https://download.tunaos.org/albacore-amd64-v2.iso) | [arm64](https://download.tunaos.org/albacore-arm64.iso)
31+
- [DX x86_64](https://download.tunaos.org/albacore-dx-amd64.iso) | [DX x86_64_v2](https://download.tunaos.org/albacore-dx-amd64-v2.iso) | [DX arm64](https://download.tunaos.org/albacore-dx-arm64.iso)
32+
- [GDX x86_64](https://download.tunaos.org/albacore-gdx-amd64.iso) | [GDX x86_64_v2](https://download.tunaos.org/albacore-gdx-amd64-v2.iso) | [GDX arm64](https://download.tunaos.org/albacore-gdx-arm64.iso)
33+
34+
#### Yellowfin (AlmaLinux Kitten 10)
35+
- [x86_64](https://download.tunaos.org/yellowfin-amd64.iso) | [x86_64_v2](https://download.tunaos.org/yellowfin-amd64-v2.iso) | [arm64](https://download.tunaos.org/yellowfin-arm64.iso)
36+
- [DX x86_64](https://download.tunaos.org/yellowfin-dx-amd64.iso) | [DX x86_64_v2](https://download.tunaos.org/yellowfin-dx-amd64-v2.iso) | [DX arm64](https://download.tunaos.org/yellowfin-dx-arm64.iso)
37+
- [GDX x86_64](https://download.tunaos.org/yellowfin-gdx-amd64.iso) | [GDX x86_64_v2](https://download.tunaos.org/yellowfin-gdx-amd64-v2.iso) | [GDX arm64](https://download.tunaos.org/yellowfin-gdx-arm64.iso)
38+
39+
### Method 2: Build Your Own ISO
40+
41+
Use the TunaOS build script to create custom ISOs:
42+
43+
```bash
44+
# Download the build script
45+
curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
46+
-o build-bootc.sh
47+
chmod +x build-bootc.sh
48+
49+
# Build an ISO for your preferred variant
50+
sudo ./build-bootc.sh iso ghcr.io/tuna-os/yellowfin:latest
51+
52+
# Or build a VM image
53+
sudo ./build-bootc.sh qcow2 ghcr.io/tuna-os/yellowfin:latest
54+
```
55+
56+
### Method 3: Container Runtime
57+
58+
For testing or container-based workflows:
59+
60+
```bash
61+
# Pull your preferred variant
62+
podman pull ghcr.io/tuna-os/albacore:latest
63+
podman pull ghcr.io/tuna-os/yellowfin:latest
64+
podman pull ghcr.io/tuna-os/bonito:latest
65+
podman pull ghcr.io/tuna-os/skipjack:latest
66+
```
67+
68+
## Post-Installation
69+
70+
After installation, TunaOS provides:
71+
72+
### Pre-installed Applications
73+
- **GNOME 48.3**: Latest GNOME desktop environment
74+
- **Homebrew**: Package manager for CLI tools and fonts
75+
- **Flathub**: Full access to Flatpak applications
76+
77+
### Getting Started
78+
1. Complete the initial setup wizard
79+
2. Install additional software via Flathub (Software app)
80+
3. Use Homebrew for command-line tools: `brew install <package>`
81+
4. Check out the [Project Bluefin documentation](https://docs.projectbluefin.io) for general usage
82+
83+
### Variant-Specific Features
84+
85+
#### DX (Developer Experience)
86+
- libvirt virtualization
87+
- Docker containers
88+
- VSCode IDE
89+
- Development toolchains
90+
91+
#### GDX (Graphical Developer Experience)
92+
- NVIDIA drivers and CUDA
93+
- AI/ML development tools
94+
- Graphics and video editing software
95+
96+
## Troubleshooting
97+
98+
### Boot Issues
99+
- Ensure Secure Boot is disabled or properly configured
100+
- Check system requirements are met
101+
- Try the x86_64_v2 variant for older hardware
102+
103+
### Installation Problems
104+
- Verify ISO integrity after download
105+
- Use a different USB creation tool (Ventoy, Rufus, dd)
106+
- Check available disk space
107+
108+
### Getting Help
109+
- 🐛 **Report Issues**: [GitHub Issues](https://github.com/tuna-os/tunaOS/issues)
110+
- 💬 **Chat**: [Matrix #tunaos:reilly.asia](https://matrix.to/#/%23tunaos:reilly.asia)
111+
- 🎮 **Discord**: [Universal Blue Community](https://discord.gg/WEu6BdFEtp)

‎docs/intro.md‎

Lines changed: 70 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,70 @@
1+
---
2+
sidebar_position: 1
3+
---
4+
5+
# Welcome to TunaOS
6+
7+
## A Collection of Cloud-Native Enterprise Linux OS Images
8+
9+
TunaOS is a curated collection of **Bootc-based desktop operating systems** that are forks of [Bluefin LTS](https://github.com/ublue-os/bluefin-lts), built on modern container technology. This is an exploration of the flexibility of Bootc and a hope that some people believe in the Enterprise Linux Desktop.
10+
11+
The plan is to provide a stable experience with up-to-date GNOME and modern tooling.
12+
13+
## ✨ Key Features
14+
15+
- **Latest GNOME**: Don't get stuck on a 3-year-old GNOME. We try to backport the latest Desktop features and bring them to the Enterprise Desktop
16+
- Currently we're shipping GNOME `48.3` while EL will be stuck on GNOME `47` for the foreseeable future
17+
- **Anaconda WebUI & Live ISO**: Modern installation experience (pending upstream)
18+
- **Homebrew**: We bake Homebrew into the image, so all your CLI apps (and fonts) are just a brew command away
19+
- **Flathub by Default**: This is a no-brainer that isn't preset in our base images. Actually get all the Flatpaks that are generally available on the net
20+
21+
## 🐠 Available Variants
22+
23+
We ship 3 versions for each base, matching upstream:
24+
25+
- **Regular**: See [Bluefin's excellent documentation](https://docs.projectbluefin.io/) for info
26+
- **DX (Developer Experience)**: Adding libvirt, Docker, VSCode, etc. [Learn more](https://docs.projectbluefin.io/dx)
27+
- **GDX (Graphical Developer Experience)**: Adding Nvidia drivers and CUDA. For Nvidia users/AI/VFX devs. [Learn more](https://docs.projectbluefin.io/gdx)
28+
29+
### Images Available
30+
31+
- **[Albacore](albacore)** - AlmaLinux 10 based
32+
- **[Yellowfin](yellowfin)** - AlmaLinux Kitten 10 based (closest to upstream Bluefin LTS)
33+
- **[Bonito](bonito)** - Fedora 42 based (cutting-edge)
34+
- **[Skipjack](skipjack)** - CentOS 10 based
35+
36+
## 📋 System Requirements
37+
38+
| Component | Minimum | Recommended |
39+
|-----------|---------|-------------|
40+
| **CPU** | x86_64, ARM64 | x86_64, ARM64 |
41+
| **RAM** | 4 GB | 8 GB+ |
42+
| **Storage** | 20 GB | 50 GB+ |
43+
44+
## 🚀 Quick Start
45+
46+
Ready to get started? Check out our [installation guide](installation) or download ISOs for your preferred variant:
47+
48+
- [Albacore Downloads](albacore#downloads)
49+
- [Yellowfin Downloads](yellowfin#downloads)
50+
- [Bonito Downloads](bonito#downloads)
51+
- [Skipjack Downloads](skipjack#downloads)
52+
53+
## 📚 External Documentation
54+
55+
Since TunaOS is based on Bluefin LTS, most documentation can be found at:
56+
57+
- [Project Bluefin Documentation](https://docs.projectbluefin.io) - Primary reference for shared functionality
58+
- [AlmaLinux Wiki](https://wiki.almalinux.org) - For AlmaLinux-specific information
59+
- [Universal Blue](https://universal-blue.org/) - Community and ecosystem info
60+
61+
## 🤝 Community & Support
62+
63+
- 🐛 **Report Issues**: [GitHub Issues](https://github.com/tuna-os/tunaOS/issues)
64+
- 💬 **Matrix Chat**: [#tunaos:reilly.asia](https://matrix.to/#/%23tunaos:reilly.asia)
65+
- 🎮 **Discord**: [Universal Blue Community](https://discord.gg/WEu6BdFEtp)
66+
- 💬 **AlmaLinux Atomic SIG**: [AlmaLinux Atomic SIG](https://chat.almalinux.org/almalinux/channels/sigatomic)
67+
68+
---
69+
70+
*TunaOS is made by James in his free time, powered by [Bootc](https://github.com/bootc-dev/bootc), and inspired by [Bluefin](https://projectbluefin.io) and the [Universal Blue](https://universal-blue.org/) Community.*

‎docs/skipjack.md‎

Lines changed: 65 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -0,0 +1,65 @@
1+
---
2+
sidebar_position: 5
3+
---
4+
5+
# Skipjack (CentOS)
6+
7+
**Based on:** CentOS 10
8+
9+
CentOS-based variant providing a stable enterprise foundation.
10+
11+
:::note Development Status
12+
This variant is currently under development. Check the [GitHub repository](https://github.com/tuna-os/tunaOS) for current progress.
13+
:::
14+
15+
## Features
16+
17+
- 🏢 **CentOS 10** enterprise foundation
18+
- 🔄 **Bootc-based** modern container approach
19+
- 🛡️ **Enterprise stability** with modern tooling
20+
21+
## Downloads
22+
23+
### Regular Edition
24+
**Image:** `ghcr.io/tuna-os/skipjack:latest`
25+
26+
**ISOs:** *Coming soon - check back for updates*
27+
28+
## Installation
29+
30+
### Using Container Image
31+
```bash
32+
podman pull ghcr.io/tuna-os/skipjack:latest
33+
```
34+
35+
### Building ISO
36+
```bash
37+
curl https://raw.githubusercontent.com/Tuna-OS/tunaOS/refs/heads/main/build-iso.sh \
38+
-o build-bootc.sh
39+
chmod +x build-bootc.sh
40+
41+
# Build Skipjack ISO (when available)
42+
sudo ./build-bootc.sh iso ghcr.io/tuna-os/skipjack:latest
43+
```
44+
45+
## Differences from Project Bluefin
46+
47+
For general functionality, refer to the [Project Bluefin Documentation](https://docs.projectbluefin.io).
48+
49+
CentOS-specific features:
50+
- Based on CentOS 10 stream packages
51+
- Enterprise Linux ecosystem compatibility
52+
- Upstream CentOS development alignment
53+
54+
## Development Status
55+
56+
This variant is under active development. Contributions welcome! Track progress:
57+
58+
- **Issues**: [GitHub Issues](https://github.com/tuna-os/tunaOS/issues)
59+
- **Source**: [GitHub Repository](https://github.com/tuna-os/tunaOS)
60+
61+
## Community Support
62+
63+
- **CentOS**: [CentOS Stream Discussion](https://forums.centos.org/)
64+
- **Universal Blue**: [Discord Community](https://discord.gg/WEu6BdFEtp)
65+
- **TunaOS**: [Matrix Chat](https://matrix.to/#/%23tunaos:reilly.asia)

0 commit comments

Comments
 (0)