2022-09-20 14:46:42 +00:00
|
|
|
# Liminix
|
|
|
|
|
|
2023-02-16 22:06:50 +00:00
|
|
|
A Nix-based system for configuring consumer wifi routers or IoT device
|
|
|
|
|
devices, of the kind that OpenWrt or DD-WRT or Gargoyle or Tomato run
|
|
|
|
|
on. It's a reboot/restart/rewrite of NixWRT.
|
2022-09-20 14:46:42 +00:00
|
|
|
|
|
|
|
|
This is not NixOS-on-your-router: it's aimed at devices that are
|
2022-09-20 22:04:08 +00:00
|
|
|
underpowered for the full NixOS experience. It uses busybox tools,
|
|
|
|
|
musl instead of GNU libc, and s6-rc instead of systemd.
|
|
|
|
|
|
2022-09-21 22:01:21 +00:00
|
|
|
The Liminix name comes from Liminis, in Latin the genitive declension
|
|
|
|
|
of "limen", or "of the threshold". Your router stands at the threshold
|
|
|
|
|
of your (online) home and everything you send to/receive from the
|
|
|
|
|
outside word goes across it.
|
|
|
|
|
|
2022-09-25 20:21:27 +00:00
|
|
|
|
2023-07-16 16:39:01 +00:00
|
|
|
## Current status (does it work yet?)
|
|
|
|
|
|
|
|
|
|
Liminix is pre-1.0. We are still finding new and better ways to do things,
|
|
|
|
|
and there is no attempt to maintain backward compatibility with the old
|
|
|
|
|
ways. This will change when it settles down.
|
|
|
|
|
|
2023-07-20 11:07:09 +00:00
|
|
|
_In general:_ development mostly happens on the `main` branch, which is
|
2023-07-16 16:39:01 +00:00
|
|
|
therefore not guaranteed to build or to work on every commit. For the
|
2023-07-20 11:07:09 +00:00
|
|
|
latest functioning version, see [the CI system](https://build.liminix.org/jobset/liminix/build) and pick a revision with all jobs green.
|
2023-07-16 16:39:01 +00:00
|
|
|
|
2023-07-20 11:07:09 +00:00
|
|
|
_In particular:_ as of July 2023, a significant re-arrangement of
|
2023-07-16 16:39:01 +00:00
|
|
|
modules and services is ongoing:
|
|
|
|
|
|
|
|
|
|
* if you are using out-of-tree configurations created before commit
|
|
|
|
|
2e50368, especially if they reference things under pkgs.liminix,
|
|
|
|
|
they will need updating. Look at changes to examples/rotuer.nix
|
|
|
|
|
for guidance
|
|
|
|
|
|
|
|
|
|
* the same is intermittently true for examples/{extensino,arhcive}.nix
|
|
|
|
|
where I've updated rotuer and not updated them to match.
|
|
|
|
|
|
2022-09-20 17:24:27 +00:00
|
|
|
|
2023-02-16 22:06:50 +00:00
|
|
|
## Documentation
|
2022-09-25 10:54:31 +00:00
|
|
|
|
2023-02-16 22:06:50 +00:00
|
|
|
Documentation is in the [doc](doc/) directory. You can build it
|
|
|
|
|
by running
|
2022-10-02 22:04:15 +00:00
|
|
|
|
2023-02-16 22:06:50 +00:00
|
|
|
nix-shell -p sphinx --run "make -C doc html"
|
2023-02-21 17:34:09 +00:00
|
|
|
|
2023-07-16 16:39:01 +00:00
|
|
|
Rendered documentation corresponding to the latest commit on `main`
|
|
|
|
|
is published to [https://www.liminix.org/doc/](https://www.liminix.org/doc/)
|
|
|
|
|
|
2023-02-21 17:34:09 +00:00
|
|
|
|
|
|
|
|
## Extremely online
|
|
|
|
|
|
|
|
|
|
There is a #liminix IRC channel on the [OFTC](https://www.oftc.net/)
|
|
|
|
|
network in which you are welcome. You can also connect with a Matrix
|
|
|
|
|
client by joining the room `#_oftc_#liminix:matrix.org`.
|
|
|
|
|
|
|
|
|
|
In the IRC channel, as in all Liminix project venues, please conduct yourself
|
|
|
|
|
according to the Liminix [Code of Conduct](CODE-OF-CONDUCT.md).
|
