Skip to content

m1n1 user guide: document build/kmutil target#266

Open
flokli wants to merge 1 commit into
AsahiLinux:mainfrom
flokli:m1n1-kmutil-script
Open

m1n1 user guide: document build/kmutil target#266
flokli wants to merge 1 commit into
AsahiLinux:mainfrom
flokli:m1n1-kmutil-script

Conversation

@flokli

@flokli flokli commented Jun 9, 2026

Copy link
Copy Markdown
Contributor

Introduced in AsahiLinux/m1n1#573, simplifying the amount of manual steps a lot.

@chadmed

chadmed commented Jun 13, 2026

Copy link
Copy Markdown
Member

Please sign off your commit

@flokli flokli force-pushed the m1n1-kmutil-script branch from 1101d60 to af4851f Compare June 14, 2026 10:31
Comment thread docs/sw/m1n1-user-guide.md
Introduced in AsahiLinux/m1n1#573, simplifying
the amount of manual steps a lot.

Signed-off-by: Florian Klink <flokli@flokli.de>
@flokli flokli force-pushed the m1n1-kmutil-script branch from af4851f to 6dfac23 Compare June 15, 2026 14:41
@flokli flokli requested a review from chadmed June 15, 2026 14:42
@jannau

jannau commented Jun 15, 2026

Copy link
Copy Markdown
Member

I'm planning to extend this to ./tools/kmutil.py build/m1n1.bin which will read build/m1n1.bin on each request and make it the only payload. This will simplify the usage on the target to sh <($HOST:$PORT).

@flokli

flokli commented Jun 15, 2026

Copy link
Copy Markdown
Contributor Author

I'm planning to extend this to ./tools/kmutil.py build/m1n1.bin which will read build/m1n1.bin on each request and make it the only payload. This will simplify the usage on the target to sh <($HOST:$PORT).

Are you ok with landing this as-is, and updating the docs later? Or you want to keep this open until that's landed?

@jannau

jannau commented Jun 15, 2026

Copy link
Copy Markdown
Member

AsahiLinux/m1n1#601 has the kmutil script server

@flokli

flokli commented Jun 15, 2026

Copy link
Copy Markdown
Contributor Author

Ok, can you cherry pick my commit into there and update it? Probably makes more sense.

@jannau jannau left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

I don't follow the comment about cherry-picking. docs and m1n1 are separate repositories. Please update this PR once AsahiLinux/m1n1#601 is merged

To build that, and expose it via a webserver, run:

```shell
ip -br a s

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

while somewhat helpful the ip command looks a little odd here. I would expect anyone using this to be familiar with their local network. kmutil.py itself could print network info at startup. I'm not going to implement that but would accept PRs.


m1n1 stage 1 release builds packaged with the Asahi Linux Installer have both of those options set. m1n1 stage 2 release builds packaged by distros should just have `RELEASE=1` (since they do not need to chainload further) and thus do not need Rust to build.

### kmutil target

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

please update for the kmutil.py script

This assumes you manually fetched the m1n1-stage1.bin from somewhere.
If you used the `build/kmutil` target above, you can also:

```

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

missing shell annotation

If you used the `build/kmutil` target above, you can also:

```
sh <(curl HOST:8000/kmutil)

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

with kmutil.py the URL could be simplified to HOST:8000.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants