Sam Lehman
4fe822b340
devshells: name shells for clarity
2025-04-08 19:31:30 +00:00
Johannes Kirschbauer
e6312601a5
docs(inventory): improve extendSettings docs
2025-04-08 15:46:13 +02:00
Johannes Kirschbauer
29fbf361a7
chore(lib/modulesDocs): move dependency on clan-core and pkgs into function args
...
This is a good idea, to make lib agnostic from clan-core
The next step could be to rename the clan-core argument name
Or to explizitly pass the actual dependencies, instead of everything in
clan-core
2025-04-08 15:30:49 +02:00
Johannes Kirschbauer
d472f0a174
doc(inventory): document experimental settings vendoring
2025-04-08 15:24:12 +02:00
Brian McGee
d1f640b145
fix(docs): add the requirement to export clan.templates in flake outputs to migration guide
2025-04-08 10:44:36 +01:00
Brian McGee
8f290c08b7
fix(docs): correct flake sample in migration guide
...
diff --git a/docs/site/manual/migration-guide.md b/docs/site/manual/migration-guide.md
index 551a3ef0..38be9a0e 100644
--- a/docs/site/manual/migration-guide.md
+++ b/docs/site/manual/migration-guide.md
@@ -77,13 +77,18 @@ For the provide flake example, your flake should now look like this:
```nix
{
inputs.nixpkgs.url = "github:nixos/nixpkgs/nixos-unstable";
+
+ inputs.clan-core = {
+ url = "git+https://git.clan.lol/clan/clan-core ";
+ inputs.nixpkgs.follows = "nixpkgs";
+ };
- outputs = { self, nixpkgs, ... }:
+ outputs = { self, nixpkgs, clan-core, ... }:
let
clan = clan-core.lib.buildClan {
self = self; # this needs to point at the repository root
specialArgs = {};
- inventory.meta.name = "NEEDS_TO_BE_UNIQUE"; # TODO: Changeme
+ meta.name = throw "Change me to something unique";
machines = {
berlin = {
2025-04-08 10:44:33 +01:00
hsjobeki
d15ac22d41
Merge pull request 'chore(lib/select): move into subfolder with a test file' ( #3175 ) from hsjobeki/clan-core:lib-cleanup into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3175
2025-04-04 12:32:32 +00:00
Johannes Kirschbauer
64e444d4cf
docs(inventory/instances): init guide for setting up the new service model
2025-04-04 14:22:35 +02:00
Jörg Thalheim
1fc2dd072b
docs/secrets: mention defaultGroups option
2025-04-03 14:02:05 +02:00
Johannes Kirschbauer
ec086c3323
fix(lib/evalClan): evalClan is an explizit lib attribute
2025-03-30 17:07:11 +02:00
Pablo Ovelleiro Corral
8ed186ce55
data-mesher: init module
...
Co-authored-by: Brian McGee <brian@bmcgee.ie >
2025-03-29 13:49:41 +00:00
hsjobeki
6da02e46b5
Merge pull request 'docs/configure: Remove reference to unfinished feature' ( #3097 ) from kenji/clan-core:docs-remove-upcoming into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3097
2025-03-25 18:12:09 +00:00
Mic92
f136e8b945
Merge pull request 'docs/index: Clear up API Reference description' ( #3098 ) from kenji/clan-core:docs-overview into main
...
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/3098
2025-03-25 09:34:18 +00:00
a-kenji
a00377b7c1
docs/configure: Fix erroneous option attribute
...
Fixes: 3094
2025-03-22 13:05:55 -07:00
a-kenji
d7d8d55c45
docs/index: Clear up API Reference description
...
The term "auto generated" gives leeway to the incorrect assumption
that this is not a curated reference that contains written documentation
especially for the rendered reference.
This is not the case.
2025-03-22 12:56:51 -07:00
a-kenji
9a9046c484
docs/configure: Remove reference to unfinished feature
2025-03-22 12:53:59 -07:00
DavHau
bc48a7a57c
docs: add guide for testing
2025-03-19 09:43:05 +00:00
DavHau
188c5dfb17
docs: move contributing+debugging to section contributing
2025-03-11 15:19:46 +07:00
Pablo Ovelleiro Corral
66332c1ae6
Add auto-upgrade module
2025-03-04 10:09:37 +01:00
a-kenji
db2530e0cd
docs/repo-layout: Remove infra section
...
Remove the public infra section, as it uses a bit of unfortunate
wording. It suggests we would add anyone to our infrastructure as an
admin.
2025-03-03 11:34:45 +00:00
a-kenji
dbf2fb26f9
docs/CONTRIBUTING: Remove internal tools documentation to streamline
...
Remove our internal developer tools documentation to streamline the
CONTRIBUTING.md guide and to not confuse external contributors.
2025-03-03 11:34:34 +00:00
a-kenji
122c493447
docs/CONTRIBUTING: Add missing article
2025-03-02 20:44:42 -08:00
a-kenji
bfae31f1ae
docs: Fix numbered markdown list
2025-03-02 20:10:43 -08:00
a-kenji
e3b0b4489a
docs/CONTRIBUTING: Clarify wrong suggestion about debugging dependent tools
2025-03-03 03:57:33 +00:00
a-kenji
d34f976057
docs/site: Fix flake-parts link
2025-03-03 03:53:49 +00:00
a-kenji
2b38fb3f9e
docs/CONTRIBUTING: Fix data-mesher reference name
2025-03-02 19:42:57 -08:00
a-kenji
ea5f2ecce9
docs/guide: Mention alternative secret store backends
2025-02-27 09:58:00 +00:00
a-kenji
39ac630086
docs/guide: Deduplicate machine instructions
2025-02-27 09:56:52 +00:00
a-kenji
87d894c3ea
docs/guide: Add devshell recommendation to getting started
...
Fixes : #2218
2025-02-25 18:16:50 +00:00
Jörg Thalheim
5dc305a3f0
recommend vars over facts
2025-02-22 03:34:40 +00:00
Qubasa
f102e17633
docs: Fix install documentation
2025-02-19 14:23:45 +07:00
Qubasa
125c2df666
docs: Fix multiple issues with the clan installation guide
2025-02-18 17:40:27 +07:00
a-kenji
09f650dab0
docs/mesh-vpn: Document inventory usage
2025-02-16 13:32:42 +07:00
a-kenji
ea22e485dd
docs: Extend backups guide
...
Closes #2792
2025-02-16 13:04:53 +07:00
Jörg Thalheim
5d42aa2f42
remove directory = self from our documentation
2025-02-15 01:48:17 +00:00
Qubasa
74a4651681
docs: Add --refresh flag to nix shell command to mitigate caching issues
2025-02-14 13:28:21 +07:00
Qubasa
ca946408f4
clan-cli: Fix garbled clan vms run output. docs: Improve debugging guide
2025-02-13 16:17:55 +07:00
Sacha Korban
04a5035e7c
docs: disc-encryption: change guide to use phases option and misc improvements
2025-02-13 17:10:07 +11:00
OliverNChalk
9cfe6850fb
docs: fix git rm step in Add Machines
2025-02-11 09:41:25 +11:00
Michael Hoang
ce3034e854
blog: actually remove asciicinema player
2025-02-04 15:48:12 +07:00
lassulus
3f19444985
clan_cli: add select command
2025-02-04 07:32:55 +00:00
Johannes Kirschbauer
83c6ad19eb
Docs: change navigation to use tabs again
2025-01-23 13:49:55 +01:00
a-kenji
673935785d
Fix various typos
2025-01-22 13:26:58 +01:00
a-kenji
42e0928b55
clanModules/mycelium: init mycelium
...
This adds a clanModule for `mycelium`.
`Mycelium` is an IPv6 overlay network written in Rust.
Each node that joins the overlay network will receive an overlay network IP in the 400::/7 range.
An example configuration might look like this in the inventory:
```nix
mycelium.default = {
roles.peer.machines = [
"berlin"
"munich"
];
config = {
topLevelDomain = "m";
openFirewall = true;
addHostedPublicNodes = true;
};
};
```
This will add the machines named `berlin` and `munich` to the `mycelium` vpn.
And will also set the toplevel domain of the mycelium vpn to `m`, meaning the
machines are now reachable via `berlin.m` and `munich.m`.
2025-01-22 11:56:10 +00:00
Qubasa
593f49abcc
clan: revert imports.nix and wait till tuesday
2025-01-18 20:21:49 +07:00
Qubasa
3e4770add6
docs: Rename mentions of inventory module to clanModule with inventory support
2025-01-18 10:17:20 +07:00
Qubasa
030b046552
Reapply "docs: Document imports dir. Remove What's next sections everywhere. Merge guide overview and hompage view."
...
This reverts commit ba517f56b3
2025-01-18 10:00:56 +07:00
Jörg Thalheim
ba517f56b3
Revert "docs: Document imports dir. Remove What's next sections everywhere. Merge guide overview and hompage view."
...
This reverts commit 257e1893ee
2025-01-17 15:44:44 +01:00
Qubasa
257e1893ee
docs: Document imports dir. Remove What's next sections everywhere. Merge guide overview and hompage view.
2025-01-17 21:03:25 +07:00
DavHau
5ce72dd261
tests: reduce unnecessary rebuilds of several tests
...
Some test were referring to the whole source code via ${self} which amde them rebuild on every single commit.
This is not mitigated by introduceing `self.filter { include = [...]; }` allowin to a content addressed subset of the source code in tests.
2025-01-17 17:00:18 +07:00
