content: add install page (incomplete)

This commit is contained in:
Kate Temkin 2024-04-27 20:32:25 -06:00
parent 8c524f2112
commit d0062aeff4
5 changed files with 125 additions and 3 deletions

View file

@ -3,6 +3,7 @@ TODO List
## Misc ## Misc
- Fix the TODO FIXME section of existing installs.
- Figure out what to replace the location section with. - Figure out what to replace the location section with.
- Fill out the "contact us" section on the main page. - Fill out the "contact us" section on the main page.
- Figure out any legalese we need on the main page. - Figure out any legalese we need on the main page.
@ -13,8 +14,7 @@ TODO List
## Pages ## Pages
- Create the `/install` page. - Create the `/install` page.
- Create a subsection for using Lix on existing NixOS, and link it to the box. - Create the `/resources` page, with resources for learning Nix.
- Create a "Why Lix" section on `/about` and link to it.
- Create the /team page and include CoI declarations. - Create the /team page and include CoI declarations.
- Figure out where to link the "Docs" link to. - Figure out where to link the "Docs" link to.
- Create a /community page linking to matrix. - Create a /community page linking to matrix.

View file

@ -60,7 +60,7 @@ menus:
buttons: buttons:
- name: "Install Lix" - name: "Install Lix"
url: "/#" url: "/install"
weight: 5 weight: 5
pre: "btn btn-primary text-light" pre: "btn btn-primary text-light"
@ -93,3 +93,8 @@ menus:
taxonomies: taxonomies:
series: "series" series: "series"
tags: "tags" tags: "tags"
markup:
goldmark:
renderer:
unsafe: true

11
content/add-to-config.md Normal file
View file

@ -0,0 +1,11 @@
---
title: "Adding Lix to Your Config"
description: "or: how to make your existing configruation Delicious"
date: "2024-04-27"
author: "Lix Team"
---
## Flake-based Configurations
## Non-Flake Configurations

101
content/install.md Normal file
View file

@ -0,0 +1,101 @@
---
title: "Installing Lix"
description: "or: how to make your configuration Delicious"
date: "2024-04-27"
author: "Lix Team"
---
Whether you're a new or returning user, **we're thrilled you've decided to pick up Lix!**
Lix works out-of-the-box on most Linux and MacOS systems, including with system management tools
such as [home-manager](https://github.com/nix-community/home-manager) and
[nix-darwin](https://github.com/LnL7/nix-darwin) -- but, like any Nix-based system, some Nix background
knowledge is recommended before installation.
If you're new to the Nix ecosystem, you may want to check out some [community resources](/resources)
first, to get familiar with how Nix works.
## On NixOS
If you haven't already installed NixOS, do so using any upstream
[install image](https://nixos.org/download/#NixOS) and the instructions in the
[NixOS Manual](https://nixos.org/manual/nixos/stable/#sec-installation). Then, follow
the instructions for either:
- [flake-based configurations](/add-to-config#flake-based-configurations); or
- [non-flake configurations](/add-to-config#non-flake-configurations)
depending on how you prefer to configure your system.
## On an Existing `nix-darwin` Install
If you already have a [nix-darwin](https://github.com/LnL7/nix-darwin) installation, you
can use the same instructions as installing on a NixOS-based system. Follow the instructions
for either:
- [flake-based configurations](/add-to-config#flake-based-configurations); or
- [non-flake configurations](/add-to-config#non-flake-configurations)
depending on how you prefer to configure your system.
## On Any Other Linux/MacOS System
You can either perform a **new install**, or choose to
**upgrade an existing install** to Lix.
### New Installs
The easiest way to install Lix is to use the [Lix Installer](https://git.lix.systems/lix-project/lix-installer)[^1].
Open a terminal, and run the following command:
```sh
$ curl -sSf -L https://install.lix.systems/lix | sh -s -- install
```
The installer will guide you through installing Lix -- and once it's finished,
you'll have a full, working installation. If you're not sure what to do, now is a
great time to check out some of the [community's resources on Nix](/resources).
### Existing Installs
If you have an existing Nix installation, you should be able to upgrade by using a variant
of the `upgrade-nix` command.
<mark>
<b>This section is currently pending on a pull request, so these instructions are for proofreading only.</b>
</mark>
<br/>
<br/>
**If you have flakes enabled**, the following command should perform an upgrade:
```sh
$ sudo nix run 'https://git.lix.systems/lix-project/lix' -- upgrade-nix
```
**If you don't have flakes enabled**, you can perform a slightly more complex command:
```sh
$ ***TODO FIXME***
```
You should now have an upgraded version of Nix. You can verify this by asking Lix
to report its version:
```sh
$ nix --version
nix (Lix, like Nix) 2.90.0-lix
```
As long as you see `Lix` in the output, you're good! If you're not sure what to do now, it's a
great time to check out some of the [community's resources on Nix](/resources).
## Having Trouble?
If you're having difficulty installing Lix, don't panic! Hop on over to our
[community page](/community), and check out the various ways to find help.
[^1]: a customized variant of the [Determinant Nix Installer](https://github.com/DeterminateSystems/nix-installer).

View file

@ -24,4 +24,9 @@
font-weight: bold; font-weight: bold;
margin-top: 2rem; margin-top: 2rem;
} }
div.footnotes {
margin-top: 5rem;
filter: opacity(60%);
}
} }