mentalnet-gnu-linux/README.md

90 lines
2.5 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 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).