How do I install it? WIKI FAQ

[WWWFWWW]

See the website for instructions: https://asahilinux.org/

doesn't really work. The website only mentions "curl and run the script". That's not really a "how to", is it...

More detailed instructions on the whole installation process would be really helpful.

[qvipin]

Open your terminal, and paste that command. It's that straightforward...

[RealTimeyt]

That is all the detail someone might need. Like qvipin said, paste the curl into the terminal and it will run you through. Do not see how this is an issue.

[WWWFWWW]

That is all the detail someone might need. Like qvipin said, paste the curl into the terminal and it will run you through. Do not see how this is an issue.

There is literally zero description of what the script does, what it does to my containers, bootloader or whatever. That's frankly not up to any standards of writing documentation, especially for software messing up with systems.

Yes, a few more details are available in the code and in the more esoteric docs on platform security, but you are totally missing my point.

I get it, devs are often shortsighted, as they know their projects throughout and well. But users don't.

A few lines of like (just a 100% made‑up example)...

1. the installer needs at least 30 GB free on the main volume
2. the installer creates a separate APFS container, using Apple's APFS tools
3. the installer registers that container with Apple's Boot Policy, setting it in Permissive Mode
4. the installer doesn't touch any other containers, and Asahi boots using

...would really help to explain how the installer works and what it actually does.

You imply that the installation is easy even for most normal or semi‑advanced users, without understandably explaining any of the above.

That's simply a bad policy, as it clearly dissuades normal or semi‑advanced users like me from ever installing it. If devs don't understand the legitimate concerns of users, perhaps they should take a few courses in user experience first, or at least try to think as users, not devs with intimate knowledge of the whole process.

[Rastafabisch]

@WWWFWWW I don't really see the issue here. While the installer does not list this beforehand it does so for every single step, before you commit any changes to your system.

And yes: the installation is that simple.

[RealTimeyt]

1. the installer needs at least 30 GB free on the main volume

While I do agree that the minimum storage requirements are a little vague ( especially because you need double that ),

clearly dissuades normal or semi‑advanced users

I do disagree on this. I genuinely do not think or consider Asahi Linux, in its current state to be for normal users. In the future it very well might be the OS to use on Apple Silicon after this extremely talented team figures out all this undocumented mess, but right now, it is very experimental and should not be used by regular users.

how the installer works and what it actually does

The target demographic for Asahi is definitely talented or interested enough to look through the website and GitHub to figure out how the installer works.

Keep in mind that this is my own opinion so don't take it too seriously.

[qvipin]

If you don't know Linux or don't want to put the effort tor read the docs, then Asahi isn't for you.

[oddforms-design]

I think an installation guide will probably come point in the wiki. I agree an overview of the install process would be nice without having to commit to actually doing it. Instructions for dual booting afterward etc. Also this line from the installer:

Please make sure you are familiar with our documentation at:
https://alx.sh/w

Sent me looking through the website for documentation related to the install process which currently doesn't exist.

[jasonehines]

It's very bad practice to run anything with root permissions (aka sudo) without knowing exactly what it does. Will this script prompt me to partition my disk for a dual boot? Will it wipe my entire drive and write the os to it? These things are important to know.

[samjcombs]

lol relax folks, you are on a github page for a linux distro known to be dual boot friendly for APPLE SILICON. Rather than nit the docs, why dont we praise the creators for such a badass work of art for all of us to enjoy!