From aa0665f2438e287ddaf5a64a6f3b03678b32b306 Mon Sep 17 00:00:00 2001 From: Florian Schmitt Date: Tue, 1 Oct 2024 15:35:09 +0300 Subject: [PATCH] feat: about page + tweaks + links between pages --- about.md | 42 +++++++++++++++++++++++++++++++++++++++++- index.md | 2 +- installation.md | 9 ++++++++- 3 files changed, 50 insertions(+), 3 deletions(-) diff --git a/about.md b/about.md index 10aee1d..e61fc14 100644 --- a/about.md +++ b/about.md @@ -1,2 +1,42 @@ -# About Nix CLIC +# About NixiN +NixiN is a web UI allowing non-technical users to easily configure their machines and VMs with NixOS. + +The idea is to provide turnkey NixOS configurations for federated and distributed web use cases. + +The base configuration will provide a common layer of hosting infrastructure, carefully chosen to achieve our objectives of security, scalability, maintainability and robustness, using modern technologies such as btrfs or zfs, private networks (wireguard, yggdrasil) and distributed storage (like garage S3, eris, DAT or IPFS). + +The users will first choose their use case(s) (for example collaborative writing, Fediverse social networks, personal data management, private cloud storage, email/web hosting, ...). + +This choice produce a pre-selection of web services that users can accept as is or fully customize by enabling/disabling some of them or even provide custom NixOS configurations for experts. + +The users will then indicate the domains they want to use, and their complete NixOS configuration will be generated, stored in their git repository, built and deployed. + +The users will be able to manage any numbers of machines/configs and will have some helpers for setting up distributed services. + +## Why NixiN ? + +We would like to provide an easy way to maintain complex web services and that more people are retaking control about their digital life. +Self hosting from scratch is hard, but declarative server configuration made easy and a more federated approach to cloud could be the holy grail! + +We love Debian and YunoHost projects, but those distributions are not designed for the latest federated technologies. +NixOs is an amazing project, but the learning curve is hard, even for experts in computers. + +**Nixin wants to be an in-between, providing an easy UI like YunoHost to manage our machines, but with the power of NixOS backed in.** + +## What is the plan ? + +**Easy plan in 3 steps** : + +1. Make a reactive UI web app that generates the configuration.nix code +2. Make a backend app that can store and manipulate multiple configuration files per user. +The backend will use private git repositories to store the configurations and a password store. +3. Use CD/CI from the git forge, but test and build + +We are still in the first step for now. + +Check [the roadmap](roadmap) for more detailed information. + +## Why this name ? + +NixiN is a palindrome so it's funny, isn't it? And it can be interpreted as "Nix in Nix", which is a valid infrastructure schema for NixiN: a host running NixOS with NixiN could run NixOS VMs configurated by NixiN. diff --git a/index.md b/index.md index 6fe99be..4fc148f 100644 --- a/index.md +++ b/index.md @@ -1,5 +1,4 @@ --- -# https://vitepress.dev/reference/default-theme-home-page layout: home hero: @@ -58,6 +57,7 @@ const members = [ NixiN is a webUI that allows non-technical users to configure NixOS machines and VMs easily. It offers pre-configured setups for various web applications, focusing on security and scalability using modern technologies. You can select use cases from bundles (like cloud storage or social networks), customize web services, and specify domains, resulting in a complete NixOS configuration stored in a git repository. The platform will support managing multiple configurations, build them and deploy them. It also provides tools for distributed services. +[Read more about NixiN](about) ## Our Team diff --git a/installation.md b/installation.md index ea72bdb..b30b616 100644 --- a/installation.md +++ b/installation.md @@ -8,7 +8,7 @@ So only requirements are : - A Linux system with virtualisation support - With Nix installed -## Grab the code and run locally +## Grab the code and build the dev environment Get the latest version from the official repository @@ -21,3 +21,10 @@ Go in the main folder and run the `shell.nix` to install dependencies ```bash cd nixin-web && nix-shell ``` + +## Run locally + +From the development shell run `npm run docs:dev` to launch the website locally, in development mode. + +The site should be accessible at (or any configured port). +