search

AsahiLinux / docs

Hardware and software docs / wiki
Other
1.76k stars 49 forks source link

How do I install it? WIKI FAQ #119

Open WWWFWWW opened 3 months ago

WWWFWWW commented 3 months ago

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 commented 3 months ago

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

RealTimeyt commented 2 weeks ago

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 commented 2 weeks ago

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

  1. the installer creates a separate APFS container, using Apple's APFS tools
  2. the installer registers that container with Apple's Boot Policy, setting it in Permissive Mode
  3. 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 commented 2 weeks ago

@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.

Disk resize prompt

And yes: the installation is that simple.

RealTimeyt commented 2 weeks ago
  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 commented 2 weeks ago

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 commented 1 week ago

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.