Commit Graph

113 Commits

Author SHA1 Message Date
Johannes Kirschbauer
fef5a0b6f2 Docs: change navigation to use sidebar sections only 2025-01-14 12:31:45 +00:00
pinpox
7ccc9f52b6 migration-guide (#2717)
This PR adds a migration guide for existing NixOS configurations.

Co-authored-by: Pablo Ovelleiro Corral <mail@pablo.tools>
Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/2717
Co-authored-by: pinpox <clan@pablo.tools>
Co-committed-by: pinpox <clan@pablo.tools>
2025-01-11 20:38:08 +00:00
DavHau
aa175d9682 vars: add guide for using vars to manage shared passwords
This could be extended forther to cover more features, but it is a start
2025-01-11 20:01:47 +07:00
Qubasa
3d0b2948f3 docs: Add debugging.md and repo-layout.md guides 2025-01-09 13:01:49 +00:00
Johannes Kirschbauer
30a99f5cb6 Chore: update docs 2024-12-31 14:22:00 +01:00
Johannes Kirschbauer
a87d0fcf92 Docs: add permanent footer with prev/next buttons 2024-12-20 19:13:55 +01:00
Michael Hoang
31ed292939 docs: update Matrix link 2024-12-11 10:18:36 +11:00
Johannes Kirschbauer
d1f624ad1f api/disk-templates: adopt directory structure from clan modules 2024-12-03 12:01:35 +01:00
DavHau
fbbfcc0aa5 vars: generate docs for cli and module 2024-11-29 17:23:31 +07:00
Johannes Kirschbauer
277bad43cf Docs/modules: move frontmatter into supmenu with overview 2024-11-20 13:21:00 +01:00
Johannes Kirschbauer
b3164076d5 Docs/modules: seperate out inventory,role specific interface 2024-11-20 11:01:28 +01:00
a-kenji
2389e3f73e clanModules: Fix ordering 2024-11-19 14:14:31 +01:00
a-kenji
4b4b3826c8 clanModules/importer: Init importer inventory module
Initialize the `importer` inventory module.
It is a power user module that allows for convenient, flexible,
structured imports for hosts.

It exposes the `extraModules` functionality of the inventory,
without any added configuration.

Closes: #2356
2024-11-19 14:00:57 +01:00
Johannes Kirschbauer
cfe9dbf117 Docs/frontmatter: init automatic reference for frontmatter 2024-11-19 10:35:13 +01:00
Qubasa
9aa4a81a91 docs: Remove old blog, remove empty concepts rider 2024-11-18 17:25:47 +01:00
a-kenji
60d7c5d82c add clanModule for zerotier inventory 2024-11-08 14:10:23 +00:00
Johannes Kirschbauer
571f36c345 Docs: fix missing icons & favicon 2024-11-06 13:56:20 +01:00
Johannes Kirschbauer
3fe83eb9d8 Docs: minor improvements 2024-10-09 09:38:31 +02:00
Johannes Kirschbauer
8fbaa3091a Docs: init module author guide 2024-10-08 14:22:16 +02:00
Johannes Kirschbauer
026481f9d7 Docs: harmonize titles 2024-09-25 14:06:55 +02:00
Johannes Kirschbauer
a67fb750cf Docs: fixup links 2024-09-25 13:46:12 +02:00
Johannes Kirschbauer
60ddd3369e Docs: restructure apply diataxis 2024-09-25 13:37:35 +02:00
Jörg Thalheim
cd67a5dc53 docs: renaming "Include Machines" to "Adding Machines" 2024-09-24 12:52:53 +02:00
Johannes Kirschbauer
37435acd79 Docs: fix flake-parts nav entry 2024-09-22 18:52:22 +02:00
Johannes Kirschbauer
55526b1fdb Docs: add top-level index, refactor according to diataxis 2024-09-22 18:39:13 +02:00
Qubasa
036cd710e1 docs: Rename guides to manual, Rename reference to options, add secure boot chapter to manual. Add secrets chapter to manual. 2024-09-20 16:52:52 +02:00
Johannes Kirschbauer
72f79dee37 Inventory: docs improvements 2024-09-16 22:52:40 +02:00
Qubasa
60397e0ca4 clanCore: init machine_id_v3 2024-09-13 12:17:49 +02:00
a-kenji
56ce3d625c clanModules/state-version: init state-version
This adds a clanModule that will initialize the `system.stateVersion`
upon deploying the machine for the first time.

If the machine is completely reinstalled, then the state version might be
regenerated. But care should be taken if rebuilding from backups.
2024-09-12 15:47:30 +02:00
a-kenji
b13ed922b1 Revert "Merge pull request 'machine_id_v2' (#2052) from Qubasa/clan-core:machine_id_v2 into main"
This reverts commit 22a11abfe5, reversing
changes made to 208b71ac0e.
2024-09-10 14:01:12 +02:00
Qubasa
5c975a5eef clanCore: init machineId and diskId v2 2024-09-09 15:51:31 +02:00
Qubasa
2efa096d29 revert machine_id pull request 2024-09-06 21:38:50 +02:00
Qubasa
4171d5ea4e clanCore: init machine_id.nix with clan.core.machine.{id,diskId} 2024-09-06 18:05:40 +02:00
Jörg Thalheim
535a39cff3 Revert "nixosModules,pkgs: remove installer. clanModules: init installer module"
This reverts commit 1090e36cf1.
2024-09-03 07:04:34 +02:00
Qubasa
1090e36cf1 nixosModules,pkgs: remove installer. clanModules: init installer module 2024-09-03 00:25:16 +02:00
clan-bot
d0e5451155 Merge pull request 'ClanModule: init Admin module' (#1978) from hsjobeki/clan-core:hsjobeki-main into main 2024-08-26 16:57:21 +00:00
Johannes Kirschbauer
e9d0b8c765 Python classes: add admin module 2024-08-26 18:41:12 +02:00
Qubasa
1a376ffc83 clanModules: Init heisenbridge matrix <-> IRC bridge 2024-08-26 16:59:53 +02:00
Qubasa
3e2b7f95a4 clanModules: Add vaultwarden module. Add nginx module. Make matrix-synapse subdomain configurable 2024-08-23 18:15:48 +02:00
Jörg Thalheim
3c04199447 Revert "Merge pull request 'clanModules: Init nginx module. matrix-synapse: don't assume domain names' (#1906) from Qubasa/clan-core:Qubasa-new-main into main"
This reverts commit 88d3223ac0, reversing
changes made to f8c20fcbe1.

Apparently this breaks assumptions about matrix: https://git.clan.lol/clan/clan-core/pulls/1906#issuecomment-13184
2024-08-21 10:03:13 +02:00
Qubasa
4bf31c2cf6 clanModules: Add acme secret prompt for nginx 2024-08-19 12:53:15 +02:00
DavHau
57a19550a0 golem: add golem-provider clan module 2024-08-19 11:50:04 +02:00
a-kenji
f12c268110 clanModules: add garage module
The garage module sets up backups for metadata automatically and
generates keys needed for deployment automatically.

What is still needed in a distributed deployment is sharing of the
generated rpc keys with other garage instances.
2024-08-14 16:01:13 +02:00
Qubasa
e3d67fe9e1 clanModule: Init dyndns module to update domains pointing to dynamic IPs 2024-08-11 18:49:42 +02:00
Qubasa
cdcbd146f2 docs: Add zfs disk encryption getting started guide with remote unlocking. 2024-08-10 12:24:49 +02:00
Qubasa
64afc0da53 docs: Fix missing nav link to iwd clan module 2024-08-07 16:04:46 +02:00
a-kenji
0a58adce18 clan: remove config subcommand
This removes the `config` subcommand from the cli and the documentation
to keep the api surface small.

While this functionality was convenient it doesn't need to be surfaced
by the clan cli.

The remaining `config` python module should be ported to the `clan-app`
in a follow up pr. Because the functionality is currently only used by
the `clan-app`.
Ideally together with: #1830.
2024-07-31 16:35:36 +00:00
a-kenji
e37a6366d8 mumble: init clan-module
This adds the `mumble` clan-module.

This allows for voice chatting in a true peer-to-peer network.
Every machine that has the module enabled is a potential host and
client - every participant has the same role.

It doesn't matter who in the network is online - as long as one of the
machines is up, one server is up and people can start their voice chat.
2024-07-30 10:55:08 +02:00
Johannes Kirschbauer
a5dd99c43d Docs: generate api docs for inventory 2024-07-19 11:07:47 +02:00
Valentin Gagarin
b3fd59a802 docs: add reference index pages
- add index pages for each reference documentation category
- move concepts pages into the reference hierarchy
- render clanModules overview page in the style of the CLI overview
2024-07-19 10:27:04 +02:00