mentalnet-gnu-linux/README.md

90 lines
2.5 KiB
Markdown
Raw Normal View History

# Mentalnet GNU/Linux
A light, TTY-only GNU/Linux distribution for 90s Intel Pentium-class
(i586) machines, built with [Buildroot](https://buildroot.org).
<p align="center">
<img src="logos/mnlogo-text.png" alt="Mentalnet GNU/Linux — Modern GNU/Linux for Legacy i586 Pentiums" width="400">
</p>
The ISO is a live CD: the entire system runs from the CD with a
read-only root filesystem, and the same CD carries a built-in hard
disk installer (`mentalnet-install`).
## Current release
**R1 "FirstStorm"** — named after DECO*27's
*Chūlán ~First Storm~* (初嵐First Storm).
## Versioning
- Major releases bump the `R<n>` number (`R1`, `R2`, ...).
- Minor releases keep the `R<n>` base version and use the codename as
the minor version.
- All codenames are taken from Vocaloid, Hatsune Miku or Kasane Teto
songs.
| Release | Codename | Song | Notes |
|---------|----------|------|-------|
| R1 | Mesmerizer | *Mesmerizer* — 32ki (Hatsune Miku & Kasane Teto) | Initial release |
| R1 | **FirstStorm** | *Chūlán ~First Storm~ (初嵐First Storm)* — DECO*27 | **Current** — swap-free installer, true i586 support, terminal/input hardening, interrupt-storm fixes |
## Quick facts
| | |
|---|---|
| Login | `root` / `mnlinux` |
| Hostname | `mentalnet` |
| Kernel | `6.12.104-mentalnet-intel32` |
| Media | Live CD with built-in installer |
| CPU | i586 (Pentium / Pentium MMX) or any newer x86 |
| RAM | 128 MB minimum (64 MB usually works) |
## Security after install
The default root password is **`mnlinux`** — please change it after
installing:
```
passwd
```
Then, for day-to-day use, create a regular user and give it sudo
privileges (sudo is included in the build):
```
adduser myuser
```
You have two options to grant sudo:
- Add the user to the `sudo` group, which the shipped sudoers file
already trusts:
```
addgroup myuser sudo
```
- Or, if you prefer the classic `wheel` group, enable it with
`visudo` (uncomment the `%wheel` line) and add the user to it:
```
visudo
addgroup myuser wheel
```
**Verify that sudo works for the new user before locking root** —
log in as the user and run, for example, `sudo ls /`.
Once sudo is confirmed working, lock the root account so it cannot
be accessed (SSH included):
```
passwd -l root
```
## Documentation
The full install and test guide — hardware requirements, QEMU
testing, the install walkthrough and troubleshooting — lives in
[`board/mentalnet/INSTALL-GUIDE.md`](board/mentalnet/INSTALL-GUIDE.md).