diff --git a/docs/mkdocs.yml b/docs/mkdocs.yml index fd06e1290..d68a57c4c 100644 --- a/docs/mkdocs.yml +++ b/docs/mkdocs.yml @@ -139,7 +139,6 @@ nav: - reference/cli/vars.md - reference/cli/vms.md - - HTTP API: api.md - Decisions: diff --git a/docs/nix/render_options/__init__.py b/docs/nix/render_options/__init__.py index 9424246fa..f8361e136 100644 --- a/docs/nix/render_options/__init__.py +++ b/docs/nix/render_options/__init__.py @@ -235,7 +235,7 @@ def produce_clan_core_docs() -> None: if module_type is not None and "submodule" not in module_type: continue core_outputs[indexfile] += ( - f" - [{submodule_name}](/reference/clan.core/{submodule_name}.md)\n" + f" - [{submodule_name}](../../reference/clan.core/{submodule_name}.md)\n" ) core_outputs[indexfile] += options_head @@ -327,9 +327,9 @@ Each `clanService`: !!! Note `clanServices` are part of Clan's next-generation service model and are intended to replace `clanModules`. - See [Migration Guide](/guides/migrations/migrate-inventory-services.md) for help on migrating. + See [Migration Guide](../../guides/migrations/migrate-inventory-services.md) for help on migrating. -Learn how to use `clanServices` in practice in the [Using clanServices guide](/guides/inventory/clanServices.md). +Learn how to use `clanServices` in practice in the [Using clanServices guide](../../guides/inventory/clanServices.md). """ with indexfile.open("w") as of: @@ -424,7 +424,7 @@ Typically needed by module authors to define roles, behavior and metadata for di !!! Note This is not a user-facing documentation, but rather meant as a reference for *module authors* - See: [clanService Authoring Guide](/guides/services/community.md) + See: [clanService Authoring Guide](../../guides/services/community.md) """ # Inventory options are already included under the clan attribute # We just omitted them in the clan docs, because we want a separate output for the inventory model @@ -457,7 +457,7 @@ def produce_inventory_docs() -> None: output = """# Inventory Submodule This provides an overview of the available options of the `inventory` model. -It can be set via the `inventory` attribute of the [`clan`](/reference/options/clan_inventory.md) function, or via the [`clan.inventory`](/reference/options/clan_inventory.md) attribute of flake-parts. +It can be set via the `inventory` attribute of the [`clan`](../../reference/options/clan_inventory.md) function, or via the [`clan.inventory`](../../reference/options/clan_inventory.md) attribute of flake-parts. """ # Inventory options are already included under the clan attribute @@ -499,8 +499,8 @@ def produce_clan_options_docs() -> None: output = """# Clan Options This provides an overview of the available options -Those can be set via [`clan-core.lib.clan`](/reference/options/clan.md) function, -or via the [`clan`](/reference/options/clan.md) attribute of flake-parts. +Those can be set via [`clan-core.lib.clan`](../../reference/options/clan.md) function, +or via the [`clan`](../../reference/options/clan.md) attribute of flake-parts. """ # Inventory options are already included under the clan attribute @@ -518,7 +518,7 @@ or via the [`clan`](/reference/options/clan.md) attribute of flake-parts. Attribute: `inventory` -See: [Inventory Submodule](/reference/options/clan_inventory.md) +See: [Inventory Submodule](../../reference/options/clan_inventory.md) """ continue output += options_docs_from_tree(option, init_level=2) diff --git a/docs/site/decisions/Architecture-decisions.md b/docs/site/decisions/Architecture-decisions.md index 607ceff43..541bd63e7 100644 --- a/docs/site/decisions/Architecture-decisions.md +++ b/docs/site/decisions/Architecture-decisions.md @@ -9,6 +9,6 @@ This section contains the architecture decisions that have been reviewed and gen ## Crafting a new ADR -1. Use the [template](/decisions/template.md) +1. Use the [template](../decisions/template.md) 2. Create the Pull request and gather feedback -3. Retreive your adr-number (see: [numbering](/decisions/03-adr-numbering-process.md)) +3. Retreive your adr-number (see: [numbering](../decisions/03-adr-numbering-process.md)) diff --git a/docs/site/getting-started/add-machines.md b/docs/site/getting-started/add-machines.md index 7f46d8a14..47a858cc9 100644 --- a/docs/site/getting-started/add-machines.md +++ b/docs/site/getting-started/add-machines.md @@ -1,10 +1,10 @@ Machines can be added using the following methods -- Create a file `machines/{machine_name}/configuration.nix` (See: [File Autoincludes](/guides/inventory/autoincludes.md)) +- Create a file `machines/{machine_name}/configuration.nix` (See: [File Autoincludes](../guides/inventory/autoincludes.md)) - Imperative via cli command: `clan machines create` -- Editing nix expressions in flake.nix See [`clan-core.lib.clan`](/options/?scope=Flake Options (clan.nix file)) +- Editing nix expressions in flake.nix See [`clan-core.lib.clan`](../reference/options/clan.md) -See the complete [list](/guides/inventory/autoincludes.md) of auto-loaded files. +See the complete [list](../guides/inventory/autoincludes.md) of auto-loaded files. ## Create a machine diff --git a/docs/site/getting-started/add-services.md b/docs/site/getting-started/add-services.md index 57433e7b5..abf3b633c 100644 --- a/docs/site/getting-started/add-services.md +++ b/docs/site/getting-started/add-services.md @@ -8,7 +8,7 @@ In Clan Services are multi-Host & role-based: - You can use tags instead of explicit machine names. -To learn more: [Guide about clanService](/guides/inventory/clanServices.md) +To learn more: [Guide about clanService](../guides/inventory/clanServices.md) !!! Important It is recommended to add at least one networking service such as `zerotier` that allows to reach all your clan machines from your setup computer across the globe. @@ -38,8 +38,8 @@ To learn more: [Guide about clanService](/guides/inventory/clanServices.md) } ``` -1. See [reference/clanServices](/reference/clanServices/index.md) for all available services and how to configure them. - Or read [authoring/clanServices](/guides/services/community.md) if you want to bring your own +1. See [reference/clanServices](../services/official/index.md) for all available services and how to configure them. + Or read [authoring/clanServices](../guides/services/community.md) if you want to bring your own 2. Replace `__YOUR_CONTROLLER_` with the *name* of your machine. @@ -71,5 +71,5 @@ Adding the following services is recommended for most users: ``` 1. The `admin` service will generate a **root-password** and **add your ssh-key** that allows for convienient administration. -2. Equivalent to directly setting `authorizedKeys` like in [configuring a machine](/getting-started/add-machines.md#configuring-a-machine) +2. Equivalent to directly setting `authorizedKeys` like in [configuring a machine](../getting-started/add-machines.md#configuring-a-machine) 3. Adds `user = jon` as a user on all machines. Will create a `home` directory, and prompt for a password before deployment. diff --git a/docs/site/getting-started/add-users.md b/docs/site/getting-started/add-users.md index 60e9d9ed9..aa55d81f9 100644 --- a/docs/site/getting-started/add-users.md +++ b/docs/site/getting-started/add-users.md @@ -3,15 +3,15 @@ The users concept of clan is not done yet. This guide outlines some solutions from our community. Defining users can be done in many different ways. We want to highlight two approaches: -- Using clan's [users](/reference/clanServices/users.md) service. +- Using clan's [users](../services/official/users.md) service. - Using a custom approach. -## Adding Users using the [users](/reference/clanServices/users.md) service +## Adding Users using the [users](../services/official/users.md) service To add a first *user* this guide will be leveraging two things: -- [clanServices](/reference/clanServices/index.md): Allows to bind arbitrary logic to something we call an `Γ¬nstance`. -- [clanServices/users](/reference/clanServices/users.md): Implements logic for adding a single user perInstance. +- [services](../services/official/index.md): Allows to bind arbitrary logic to something we call an `Γ¬nstance`. +- [services/users](../services/official/users.md): Implements logic for adding a single user perInstance. The example shows how to add a user called `jon`: @@ -49,7 +49,7 @@ The example shows how to add a user called `jon`: The `users` service creates a `/home/jon` directory, allows `jon` to sign in and will take care of the user's password. -For more information see [clanService/users](/reference/clanServices/users.md) +For more information see [services/users](../services/official/users.md) ## Using a custom approach diff --git a/docs/site/getting-started/convert-existing-NixOS-configuration.md b/docs/site/getting-started/convert-existing-NixOS-configuration.md index 55c3ca6ad..fbe755622 100644 --- a/docs/site/getting-started/convert-existing-NixOS-configuration.md +++ b/docs/site/getting-started/convert-existing-NixOS-configuration.md @@ -2,7 +2,7 @@ This guide will help you convert your existing NixOS configurations into a Clan. !!! Warning Migrating instead of starting new can be trickier and might lead to bugs or - unexpected issues. We recommend reading the [Getting Started](/getting-started/creating-your-first-clan.md) guide first. + unexpected issues. We recommend reading the [Getting Started](../getting-started/creating-your-first-clan.md) guide first. Once you have a working setup and understand the concepts transfering your NixOS configurations over is easy. @@ -169,7 +169,7 @@ Clan needs to know where it can reach your hosts. For testing purpose set } ``` -See our guide on for properly [configuring machines networking](/guides/networking/networking.md) +See our guide on for properly [configuring machines networking](../guides/networking/networking.md) ## Next Steps diff --git a/docs/site/getting-started/deploy-to-physical-machine/flash-installer.md b/docs/site/getting-started/deploy-to-physical-machine/flash-installer.md index 6ab7cae15..365b9a08e 100644 --- a/docs/site/getting-started/deploy-to-physical-machine/flash-installer.md +++ b/docs/site/getting-started/deploy-to-physical-machine/flash-installer.md @@ -1,7 +1,7 @@ To install Clan on physical machines, you need to use our custom installer image. This is necessary for proper installation and operation. !!! note "Deploying to a Virtual Machine?" - If you're deploying to a virtual machine (VM), you can skip this section and go directly to the [Deploy Virtual Machine](/getting-started/deploy-to-virtual-machine.md) step. In this scenario, we automatically use [nixos-anywhere](https://github.com/nix-community/nixos-anywhere) to replace the kernel during runtime. + If you're deploying to a virtual machine (VM), you can skip this section and go directly to the [Deploy Virtual Machine](../../getting-started/deploy-to-virtual-machine.md) step. In this scenario, we automatically use [nixos-anywhere](https://github.com/nix-community/nixos-anywhere) to replace the kernel during runtime. ??? info "Why nixos-anywhere Doesn't Work on Physical Hardware?" nixos-anywhere relies on [kexec](https://wiki.archlinux.org/title/Kexec) to replace the running kernel with our custom one. This method often has compatibility issues with real hardware, especially systems with dedicated graphics cards like laptops and servers, leading to crashes and black screens. @@ -150,7 +150,7 @@ sudo umount /dev/sdb1 ## Boot From USB Stick -- To use, boot from the Clan USB drive with **secure boot turned off**. For step by step instructions go to [Disabling Secure Boot](/guides/) +- To use, boot from the Clan USB drive with **secure boot turned off**. For step by step instructions go to [Disabling Secure Boot](../../guides/secure-boot.md) ## (Optional) Connect to Wifi Manually diff --git a/docs/site/getting-started/deploy-to-physical-machine/install-machine.md b/docs/site/getting-started/deploy-to-physical-machine/install-machine.md index 6395bbd81..4add413c2 100644 --- a/docs/site/getting-started/deploy-to-physical-machine/install-machine.md +++ b/docs/site/getting-started/deploy-to-physical-machine/install-machine.md @@ -4,13 +4,13 @@ Now that you have created a machine, added some services, and set up secrets, th ### Prerequisites - [x] RAM > 2GB - [x] **Two Computers**: You need one computer that you're getting ready (we'll call this the Target Computer) and another one to set it up from (we'll call this the Setup Computer). Make sure both can talk to each other over the network using SSH. -- [x] **Machine configuration**: See our basic [adding and configuring machine guide](/getting-started/add-machines.md) -- [x] **Initialized secrets**: See [secrets](/guides/secrets.md) for how to initialize your secrets. -- [x] **USB Flash Drive**: See [Clan Installer](/getting-started/flash-installer.md) +- [x] **Machine configuration**: See our basic [adding and configuring machine guide](../../getting-started/add-machines.md) +- [x] **Initialized secrets**: See [secrets](../../guides/secrets.md) for how to initialize your secrets. +- [x] **USB Flash Drive**: See [Clan Installer](../../getting-started/deploy-to-physical-machine/flash-installer.md) ### Image Installer -This method makes use of the [image installers](/getting-started/flash-installer.md). +This method makes use of the [image installers](../../getting-started/deploy-to-physical-machine/flash-installer.md). The installer will randomly generate a password and local addresses on boot, then run a SSH server with these preconfigured. The installer shows its deployment relevant information in two formats, a text form, as well as a QR code. @@ -66,7 +66,7 @@ This is an example of the booted installer. ``` 2. The root password for the installer medium. This password is autogenerated and meant to be easily typeable. -3. See how to connect the installer medium to wlan [here](/getting-started/flash-installer.md). +3. See how to connect the installer medium to wlan [here](../../getting-started/deploy-to-physical-machine/flash-installer.md). !!!tip For easy sharing of deployment information via QR code, we highly recommend using [KDE Connect](https://apps.kde.org/de/kdeconnect/). @@ -111,4 +111,4 @@ The following command will generate a hardware report with [nixos-facter](https: If you are using our template `[MACHINE]` would be `jon` -[Next Step (Choose Disk Format)](/getting-started/configure-disk.md){ .md-button .md-button--primary } \ No newline at end of file +[Next Step (Choose Disk Format)](../../getting-started/configure-disk.md){ .md-button .md-button--primary } \ No newline at end of file diff --git a/docs/site/getting-started/deploy-to-virtual-machine.md b/docs/site/getting-started/deploy-to-virtual-machine.md index b191c4d45..b6250bf28 100644 --- a/docs/site/getting-started/deploy-to-virtual-machine.md +++ b/docs/site/getting-started/deploy-to-virtual-machine.md @@ -2,7 +2,7 @@ ## Prerequisites - [x] RAM > 2GB - [x] **Two Computers**: You need one computer that you're getting ready (we'll call this the Target Computer) and another one to set it up from (we'll call this the Setup Computer). Make sure both can talk to each other over the network using SSH. -- [x] **Machine configuration**: See our basic [adding and configuring machine guide](/getting-started/add-machines.md) +- [x] **Machine configuration**: See our basic [adding and configuring machine guide](../getting-started/add-machines.md) Clan supports any cloud machine if it is reachable via SSH and supports `kexec`. diff --git a/docs/site/getting-started/update-machines.md b/docs/site/getting-started/update-machines.md index 82cfffda3..8f2b795e6 100644 --- a/docs/site/getting-started/update-machines.md +++ b/docs/site/getting-started/update-machines.md @@ -31,7 +31,7 @@ Ensure that the root login is secured and only used when necessary. ## Multiple Target Hosts -You can now experiment with a new interface that allows you to define multiple `targetHost` addresses for different VPNs. Learn more and try it out in our [networking guide](/guides/networking/networking.md). +You can now experiment with a new interface that allows you to define multiple `targetHost` addresses for different VPNs. Learn more and try it out in our [networking guide](../guides/networking/networking.md). ## Updating Machine Configurations @@ -78,7 +78,7 @@ clan { `buildHost` / `targetHost`, and other network settings can be temporarily overridden for a single command: -For the full list of flags refer to the [Clan CLI](/reference/cli/index.md) +For the full list of flags refer to the [Clan CLI](../reference/cli/index.md) ```bash # Build on a remote host diff --git a/docs/site/guides/backups/backup-intro.md b/docs/site/guides/backups/backup-intro.md index 67039be93..1a46d3559 100644 --- a/docs/site/guides/backups/backup-intro.md +++ b/docs/site/guides/backups/backup-intro.md @@ -4,7 +4,7 @@ This guide explains how to use the Clan backup and state management interface to ## State Management -Clan backups are based on the concept of [states](/reference/clan.core/state.md). A state is a Nix attribute set, defined as `clan.core.state. = {};`, which specifies the files or directories to back up. +Clan backups are based on the concept of [states](../../reference/clan.core/state.md). A state is a Nix attribute set, defined as `clan.core.state. = {};`, which specifies the files or directories to back up. For example, if you have a clan service called `linkding`, you can define the folders to back up as follows: diff --git a/docs/site/guides/contributing/debugging.md b/docs/site/guides/contributing/debugging.md index 6ed2620ed..2a7701f96 100644 --- a/docs/site/guides/contributing/debugging.md +++ b/docs/site/guides/contributing/debugging.md @@ -26,7 +26,7 @@ pkgs.mkShell { ## Debugging nixos-anywhere -If you encounter a bug in a complex shell script such as `nixos-anywhere`, start by replacing the `nixos-anywhere` command with a local checkout of the project, look in the [contribution](/guides/CONTRIBUTING.md) section for an example. +If you encounter a bug in a complex shell script such as `nixos-anywhere`, start by replacing the `nixos-anywhere` command with a local checkout of the project, look in the [contribution](../../guides/contributing/CONTRIBUTING.md) section for an example. ## The Debug Flag diff --git a/docs/site/guides/disk-encryption.md b/docs/site/guides/disk-encryption.md index f8e36a085..f3bc619e7 100644 --- a/docs/site/guides/disk-encryption.md +++ b/docs/site/guides/disk-encryption.md @@ -5,7 +5,7 @@ This guide provides an example setup for a single-disk ZFS system with native en This configuration only applies to `systemd-boot` enabled systems and **requires** UEFI booting. !!! Info "Secure Boot" - This guide is compatible with systems that have [secure boot disabled](/guides/secure-boot.md). If you encounter boot issues, check if secure boot needs to be disabled in your UEFI settings. + This guide is compatible with systems that have [secure boot disabled](../guides/secure-boot.md). If you encounter boot issues, check if secure boot needs to be disabled in your UEFI settings. Replace the highlighted lines with your own disk-id. You can find our your disk-id by executing: diff --git a/docs/site/guides/flake-parts.md b/docs/site/guides/flake-parts.md index 4c3747a0f..b3cee3886 100644 --- a/docs/site/guides/flake-parts.md +++ b/docs/site/guides/flake-parts.md @@ -23,7 +23,7 @@ inputs = { ## Step 2: Import the Clan flake-parts Module -Next, import the Clan flake-parts module to make the [Clan options](/options) available within `mkFlake`: +Next, import the Clan flake-parts module to make the [Clan options](../reference/options/clan.md) available within `mkFlake`: ```nix { diff --git a/docs/site/guides/inventory/clanServices.md b/docs/site/guides/inventory/clanServices.md index a2ed7ea7e..e07ad7127 100644 --- a/docs/site/guides/inventory/clanServices.md +++ b/docs/site/guides/inventory/clanServices.md @@ -68,7 +68,7 @@ inventory.instances = { ## Module Settings Each role might expose configurable options. See clan's [clanServices -reference](/reference/clanServices/index.md) for all available options. +reference](../../services/official/index.md) for all available options. Settings can be set in per-machine or per-role. The latter is applied to all machines that are assigned to that role. @@ -155,13 +155,13 @@ inventory.instances = { You can use services exposed by Clan's core module library, `clan-core`. -πŸ”— See: [List of Available Services in clan-core](/reference/clanServices/index.md) +πŸ”— See: [List of Available Services in clan-core](../../services/official/index.md) ## Defining Your Own Service You can also author your own `clanService` modules. -πŸ”— Learn how to write your own service: [Authoring a service](/guides/services/community.md) +πŸ”— Learn how to write your own service: [Authoring a service](../../guides/services/community.md) You might expose your service module from your flake β€” this makes it easy for other people to also use your module in their clan. @@ -177,5 +177,5 @@ ______________________________________________________________________ ## What's Next? -- [Author your own clanService β†’](/guides/services/community.md) -- [Migrate from clanModules β†’](/guides/migrations/migrate-inventory-services.md) +- [Author your own clanService β†’](../../guides/services/community.md) +- [Migrate from clanModules β†’](../../guides/migrations/migrate-inventory-services.md) diff --git a/docs/site/guides/inventory/inventory.md b/docs/site/guides/inventory/inventory.md index 748f51f93..363087ffe 100644 --- a/docs/site/guides/inventory/inventory.md +++ b/docs/site/guides/inventory/inventory.md @@ -17,13 +17,13 @@ The following tutorial will walk through setting up a Backup service where the t ## Prerequisites -- [x] [Add some machines](/getting-started/add-machines.md) to your Clan. +- [x] [Add some machines](../../getting-started/add-machines.md) to your Clan. ## Services The inventory defines `instances` of clan services. Membership of `machines` is defined via `roles` exclusively. -See each [modules documentation](/reference/clanServices/index.md) for its available roles. +See each [modules documentation](../../services/official/index.md) for its available roles. ### Adding services to machines diff --git a/docs/site/guides/macos.md b/docs/site/guides/macos.md index 31d4c7215..8ab609e5a 100644 --- a/docs/site/guides/macos.md +++ b/docs/site/guides/macos.md @@ -7,7 +7,7 @@ This guide explains how to manage macOS machines using Clan. Currently, Clan supports the following features for macOS: - `clan machines update` for existing [nix-darwin](https://github.com/nix-darwin/nix-darwin) installations -- Support for [vars](/guides/vars/vars-overview.md) +- Support for [vars](../guides/vars/vars-overview.md) ## Add Your Machine to Your Clan Flake diff --git a/docs/site/guides/migrations/disk-id.md b/docs/site/guides/migrations/disk-id.md index 747ab52c0..f71d63d11 100644 --- a/docs/site/guides/migrations/disk-id.md +++ b/docs/site/guides/migrations/disk-id.md @@ -95,4 +95,4 @@ We are going to make three changes: These steps are only needed for existing configurations that depend on the `diskId` module. -For newer machines clan offers simple *disk templates* via its [templates cli](/reference/cli/templates.md) +For newer machines clan offers simple *disk templates* via its [templates cli](../../reference/cli/templates.md) diff --git a/docs/site/guides/migrations/migrate-inventory-services.md b/docs/site/guides/migrations/migrate-inventory-services.md index bf44a8a20..8d8596fb8 100644 --- a/docs/site/guides/migrations/migrate-inventory-services.md +++ b/docs/site/guides/migrations/migrate-inventory-services.md @@ -1,7 +1,7 @@ # Migrating from using `clanModules` to `clanServices` **Audience**: This is a guide for **people using `clanModules`**. -If you are a **module author** and need to migrate your modules please consult our **new** [clanServices authoring guide](/guides/services/community.md) +If you are a **module author** and need to migrate your modules please consult our **new** [clanServices authoring guide](../../guides/services/community.md) ## What's Changing? @@ -157,7 +157,7 @@ instances = { ### Move `services` entries to `instances` -Check if a service that you use has been migrated [In our reference](/reference/clanServices/index.md) +Check if a service that you use has been migrated [In our reference](../../services/official/index.md) In your inventory, move it from: @@ -247,45 +247,45 @@ The following table shows the migration status of each deprecated clanModule: | clanModule | Migration Status | Notes | |--------------------------|-------------------------------------------------------------------|------------------------------------------------------------------| -| `admin` | βœ… [Migrated](/reference/clanServices/admin.md) | | +| `admin` | βœ… [Migrated](../../services/official/admin.md) | | | `auto-upgrade` | ❌ Removed | | | `borgbackup-static` | ❌ Removed | | -| `borgbackup` | βœ… [Migrated](/reference/clanServices/borgbackup.md) | | -| `data-mesher` | βœ… [Migrated](/reference/clanServices/data-mesher.md) | | +| `borgbackup` | βœ… [Migrated](../../services/official/borgbackup.md) | | +| `data-mesher` | βœ… [Migrated](../../services/official/data-mesher.md) | | | `deltachat` | ❌ Removed | | | `disk-id` | ❌ Removed | | -| `dyndns` | βœ… [Migrated](/reference/clanServices/dyndns.md) | | +| `dyndns` | βœ… [Migrated](../../services/official/dyndns.md) | | | `ergochat` | ❌ Removed | | -| `garage` | βœ… [Migrated](/reference/clanServices/garage.md) | | +| `garage` | βœ… [Migrated](../../services/official/garage.md) | | | `golem-provider` | ❌ Removed | | | `heisenbridge` | ❌ Removed | | -| `importer` | βœ… [Migrated](/reference/clanServices/importer.md) | | -| `iwd` | ❌ Removed | Use [wifi service](/reference/clanServices/wifi.md) instead | -| `localbackup` | βœ… [Migrated](/reference/clanServices/localbackup.md) | | +| `importer` | βœ… [Migrated](../../services/official/importer.md) | | +| `iwd` | ❌ Removed | Use [wifi service](../../services/official/wifi.md) instead | +| `localbackup` | βœ… [Migrated](../../services/official/localbackup.md) | | | `localsend` | ❌ Removed | | -| `machine-id` | βœ… [Migrated](/reference/clan.core/settings.md) | Now an [option](/reference/clan.core/settings.md) | -| `matrix-synapse` | βœ… [Migrated](/reference/clanServices/matrix-synapse.md) | | +| `machine-id` | βœ… [Migrated](../../reference/clan.core/settings.md) | Now an [option](../../reference/clan.core/settings.md) | +| `matrix-synapse` | βœ… [Migrated](../../services/official/matrix-synapse.md) | | | `moonlight` | ❌ Removed | | | `mumble` | ❌ Removed | | -| `mycelium` | βœ… [Migrated](/reference/clanServices/mycelium.md) | | +| `mycelium` | βœ… [Migrated](../../services/official/mycelium.md) | | | `nginx` | ❌ Removed | | -| `packages` | βœ… [Migrated](/reference/clanServices/packages.md) | | -| `postgresql` | βœ… [Migrated](/reference/clan.core/settings.md) | Now an [option](/reference/clan.core/settings.md) | -| `root-password` | βœ… [Migrated](/reference/clanServices/users.md) | See [migration guide](/reference/clanServices/users.md#migration-from-root-password-module) | +| `packages` | βœ… [Migrated](../../services/official/packages.md) | | +| `postgresql` | βœ… [Migrated](../../reference/clan.core/settings.md) | Now an [option](../../reference/clan.core/settings.md) | +| `root-password` | βœ… [Migrated](../../services/official/users.md) | See [migration guide](../../services/official/users.md#migration-from-root-password-module) | | `single-disk` | ❌ Removed | | -| `sshd` | βœ… [Migrated](/reference/clanServices/sshd.md) | | -| `state-version` | βœ… [Migrated](/reference/clan.core/settings.md) | Now an [option](/reference/clan.core/settings.md) | +| `sshd` | βœ… [Migrated](../../services/official/sshd.md) | | +| `state-version` | βœ… [Migrated](../../reference/clan.core/settings.md) | Now an [option](../../reference/clan.core/settings.md) | | `static-hosts` | ❌ Removed | | | `sunshine` | ❌ Removed | | | `syncthing-static-peers` | ❌ Removed | | -| `syncthing` | βœ… [Migrated](/reference/clanServices/syncthing.md) | | +| `syncthing` | βœ… [Migrated](../../services/official/syncthing.md) | | | `thelounge` | ❌ Removed | | -| `trusted-nix-caches` | βœ… [Migrated](/reference/clanServices/trusted-nix-caches.md) | | -| `user-password` | βœ… [Migrated](/reference/clanServices/users.md) | | +| `trusted-nix-caches` | βœ… [Migrated](../../services/official/trusted-nix-caches.md) | | +| `user-password` | βœ… [Migrated](../../services/official/users.md) | | | `vaultwarden` | ❌ Removed | | | `xfce` | ❌ Removed | | | `zerotier-static-peers` | ❌ Removed | | -| `zerotier` | βœ… [Migrated](/reference/clanServices/zerotier.md) | | +| `zerotier` | βœ… [Migrated](../../services/official/zerotier.md) | | | `zt-tcp-relay` | ❌ Removed | | --- @@ -378,6 +378,6 @@ instances = { ## Further reference -* [Inventory Concept](/guides/inventory/inventory.md) -* [Authoring a 'clan.service' module](/guides/services/community.md) -* [ClanServices](/guides/inventory/clanServices.md) +* [Inventory Concept](../../guides/inventory/inventory.md) +* [Authoring a 'clan.service' module](../../guides/services/community.md) +* [ClanServices](../../guides/inventory/clanServices.md) diff --git a/docs/site/guides/migrations/migration-facts-vars.md b/docs/site/guides/migrations/migration-facts-vars.md index caf05c3ae..4c3c6795a 100644 --- a/docs/site/guides/migrations/migration-facts-vars.md +++ b/docs/site/guides/migrations/migration-facts-vars.md @@ -2,10 +2,10 @@ For a high level overview about `vars` see our [blog post](https://clan.lol/blog/vars/). -This guide will help you migrate your modules that still use our [`facts`](/guides/migrations/migration-facts-vars.md) backend -to the [`vars`](/guides/vars/vars-overview.md) backend. +This guide will help you migrate your modules that still use our [`facts`](../../guides/migrations/migration-facts-vars.md) backend +to the [`vars`](../../guides/vars/vars-overview.md) backend. -The `vars` [module](/reference/clan.core/vars.md) and the clan [command](/reference/cli/vars.md) work in tandem, they should ideally be kept in sync. +The `vars` [module](../../reference/clan.core/vars.md) and the clan [command](../../reference/cli/vars.md) work in tandem, they should ideally be kept in sync. ## Keep Existing Values diff --git a/docs/site/guides/nixos-rebuild.md b/docs/site/guides/nixos-rebuild.md index a34da1edb..1b62984f1 100644 --- a/docs/site/guides/nixos-rebuild.md +++ b/docs/site/guides/nixos-rebuild.md @@ -64,5 +64,5 @@ nixos-rebuild switch --flake .#my-machine --target-host root@target-ip --build-h ## Related Documentation -- [Update Your Machines](/getting-started/update-machine.md) - Using clan's update command -- [Variables (Vars)](/guides/vars/vars-overview.md) - Understanding the vars system +- [Update Your Machines](../getting-started/update-machines.md) - Using clan's update command +- [Variables (Vars)](../guides/vars/vars-overview.md) - Understanding the vars system diff --git a/docs/site/guides/secrets.md b/docs/site/guides/secrets.md index c90b0a9cd..5d027de34 100644 --- a/docs/site/guides/secrets.md +++ b/docs/site/guides/secrets.md @@ -1,5 +1,5 @@ -This article provides an overview over the underlying secrets system which is used by [Vars](/guides/vars/vars-overview.md). -Under most circumstances you should use [Vars](/guides/vars/vars-overview.md) directly instead. +This article provides an overview over the underlying secrets system which is used by [Vars](../guides/vars/vars-overview.md). +Under most circumstances you should use [Vars](../guides/vars/vars-overview.md) directly instead. Consider using `clan secrets` only for managing admin users and groups, as well as a debugging tool. @@ -11,7 +11,7 @@ Clan enables encryption of secrets (such as passwords & keys) ensuring security By default, Clan uses the [sops](https://github.com/getsops/sops) format and integrates with [sops-nix](https://github.com/Mic92/sops-nix) on NixOS machines. -Clan can also be configured to be used with other secret store [backends](/reference/clan.core/vars.md#clan.core.vars.settings.secretStore). +Clan can also be configured to be used with other secret store [backends](../reference/clan.core/vars.md#clan.core.vars.settings.secretStore). ## Create Your Admin Keypair diff --git a/docs/site/guides/services/community.md b/docs/site/guides/services/community.md index c34443b8d..d68983ea6 100644 --- a/docs/site/guides/services/community.md +++ b/docs/site/guides/services/community.md @@ -3,9 +3,9 @@ ## Service Module Specification This section explains how to author a clan service module. -We discussed the initial architecture in [01-clan-service-modules](/decisions/01-Clan-Modules.md) and decided to rework the format. +We discussed the initial architecture in [01-clan-service-modules](../../decisions/01-Clan-Modules.md) and decided to rework the format. -For the full specification and current state see: **[Service Author Reference](/reference/options/clan_service.md)** +For the full specification and current state see: **[Service Author Reference](../../reference/options/clan_service.md)** ### A Minimal module @@ -47,7 +47,7 @@ The imported module file must fulfill at least the following requirements: } ``` -For more attributes see: **[Service Author Reference](/reference/options/clan_service.md)** +For more attributes see: **[Service Author Reference](../../reference/options/clan_service.md)** ### Adding functionality to the module @@ -300,6 +300,6 @@ instnaces.machine-type = { ## Further Reading -- [Reference Documentation for Service Authors](/reference/options/clan_service.md) -- [Migration Guide from ClanModules to ClanServices](/guides/migrations/migrate-inventory-services.md) -- [Decision that lead to ClanServices](/decisions/01-Clan-Modules.md) +- [Reference Documentation for Service Authors](../../reference/options/clan_service.md) +- [Migration Guide from ClanModules to ClanServices](../../guides/migrations/migrate-inventory-services.md) +- [Decision that lead to ClanServices](../../decisions/01-Clan-Modules.md) diff --git a/docs/site/guides/vars/vars-backend.md b/docs/site/guides/vars/vars-backend.md index edae7df3b..f3b22ad84 100644 --- a/docs/site/guides/vars/vars-backend.md +++ b/docs/site/guides/vars/vars-backend.md @@ -1,6 +1,6 @@ The `clan vars` subcommand is a powerful tool for managing machine-specific variables in a declarative and reproducible way. This guide will walk you through its usage, from setting up a generator to sharing and updating variables across machines. -For a detailed API reference, see the [vars module documentation](/reference/clan.core/vars.md). +For a detailed API reference, see the [vars module documentation](../../reference/clan.core/vars.md). In this guide, you will learn how to: diff --git a/docs/site/guides/vars/vars-overview.md b/docs/site/guides/vars/vars-overview.md index 2eca03ec3..5d7ef3649 100644 --- a/docs/site/guides/vars/vars-overview.md +++ b/docs/site/guides/vars/vars-overview.md @@ -140,5 +140,5 @@ clan machines update my-machine ## Migration from Facts -If you're currently using the legacy facts system, see our [Migration Guide](/guides/migrations/migration-facts-vars.md) for step-by-step instructions on upgrading to vars. +If you're currently using the legacy facts system, see our [Migration Guide](../../guides/migrations/migration-facts-vars.md) for step-by-step instructions on upgrading to vars. diff --git a/docs/site/index.md b/docs/site/index.md index 0c1d91f25..73a1fa5b1 100644 --- a/docs/site/index.md +++ b/docs/site/index.md @@ -85,26 +85,26 @@ hide: --- -[Get started](/getting-started/creating-your-first-clan.md){ .md-button .md-button--primary } +[Get started](./getting-started/creating-your-first-clan.md){ .md-button .md-button--primary } [View on Gitea](https://git.clan.lol/clan/clan-core){ .md-button } ## Guides
-- [Inventory](/guides/inventory/inventory.md) +- [Inventory](./guides/inventory/inventory.md) --- Learn how about inventory -- [Vars](/guides/vars/vars-overview.md) +- [Vars](./guides/vars/vars-overview.md) --- Learn how to use vars -- [macOS](/guides/macos.md) +- [macOS](./guides/macos.md) --- @@ -116,7 +116,7 @@ hide:
-- [CLI](/reference/cli/index.md) +- [CLI](./reference/cli/index.md) --- @@ -128,7 +128,7 @@ hide: Search all options -- [Services](/reference/clanServices/index.md) +- [Services](./services/official/index.md) ---