Merge pull request 'docs/update: mention build-host local and uploading flake inputs' (#4614) from local-build into main

Reviewed-on: https://git.clan.lol/clan/clan-core/pulls/4614
This commit is contained in:
Mic92
2025-08-06 10:18:28 +00:00

View File

@@ -45,6 +45,16 @@ buildClan {
}; };
``` ```
You can also override the build host via the command line:
```bash
# Build on a remote host
clan machines update jon --build-host root@192.168.1.10
# Build locally (useful for testing or when the target has limited resources)
clan machines update jon --build-host local
```
!!! Note !!! Note
Make sure that the CPU architecture is the same for the buildHost as for the targetHost. Make sure that the CPU architecture is the same for the buildHost as for the targetHost.
Example: Example:
@@ -82,3 +92,18 @@ buildClan {
``` ```
This is useful for machines that are not always online or are not part of the regular update cycle. This is useful for machines that are not always online or are not part of the regular update cycle.
### Uploading Flake Inputs
When updating remote machines, flake inputs are usually fetched by the build host.
However, if your flake inputs require authentication (e.g., private repositories),
you can use the `--upload-inputs` flag to upload all inputs from your local machine:
```bash
clan machines update jon --upload-inputs
```
This is particularly useful when:
- Your flake references private Git repositories
- Authentication credentials are only available on your local machine
- The build host doesn't have access to certain network resources