From 0ed21403a89143af42911177474a5f752940d1cb Mon Sep 17 00:00:00 2001 From: Hector Martin Date: Jul 31 2024 17:10:21 +0000 Subject: Add a bunch more FAQs --- diff --git a/modules/ROOT/pages/faq.adoc b/modules/ROOT/pages/faq.adoc index 27ae2ba..988a1ba 100644 --- a/modules/ROOT/pages/faq.adoc +++ b/modules/ROOT/pages/faq.adoc @@ -32,9 +32,39 @@ Fedora Asahi Remix can be installed from https://fedora-asahi-remix.org or from Both endpoints serve the same installation images, so there is no difference in the resulting system if the same installation option is chosen. +=== What devices and hardware are supported? + +The Asahi Linux project website maintains a https://asahilinux.org/fedora/[landing page] with device support information, which is kept up to date as features and new devices are added. {variant-name} closely follows the upstream kernels and support packages, so you can expect support to be on par with that page. + +For more detailed information on specific driver and kernel support, visit the https://github.com/AsahiLinux/docs/wiki[Asahi Linux wiki] and browse the Feature Support pages (linked at the top of the sidebar). + +=== Can I install to external storage? + +We currently do not have a supported process to install to external storage. The Apple Silicon platform in general cannot boot from external storage at all, so some components must always be installed to internal storage. It is possible to manually move the root filesystem to external storage, but there are limitations (e.g. sleep mode is not currently supported as it causes external disks to re-enumerate) and therefore this is left as an exercise for the advanced user. + +In the future, we expect to have a supported process for external-storage installs that does not require re-partitioning the internal disk (taking advantage of the same mechanism used for macOS installs to external storage), but this is not ready yet. Note that such external installs will still be tied to the machine they were installed on (since some components would still be installed to the internal disk, as the platform requires this to boot). + +=== Can I run software built for x86-64 (Intel/AMD)? + +We are currently working on integrating x86 and x86-64 emulation to support running proprietary software that is not available for aarch64 (similar to Rosetta for macOS), including Windows games via Steam/Proton and Wine. However, this isn't quite ready yet, so stay tuned for updates! + +`box64` is available in the Fedora repositories and can be used to run some native x86-64 Linux software, including some games. Note that compatibility is limited to a subset of 64-bit native Linux software (32-bit software will not run, nor can `box64` be used to run Windows apps with Wine at this time). + +For Free/Open Source Software, it is always preferable to make a build for aarch64 (ARM64) instead of trying to emulate an x86-64 build. If your favorite software package is not yet available for this architecture, please request it from its developers! Users comfortable with building software may want to try building it themselves. If you do so, consider becoming a xref:package-maintainers::Joining_the_Package_Maintainers.adoc[becoming a package maintainer] to help bring the software to all Fedora users. + +Sometimes there are options other than running x86-64 software, such as native third-party alternatives or web versions. See the <> section for some examples. + == HOWTOs -=== How do I access protected content in browsers (Widevine DRM) +=== How do I access the GRUB menu? + +Server and Minimal installs should show the GRUB menu by default. For desktop installs, you have to press Escape at the right time to enter the GRUB menu. + +When the system boots, you will see the display cycle through m1n1 (Asahi Linux or Fedora logos) and U-Boot (text screen with U-Boot logo on the top right). The U-Boot screen will show a brief countdown. Press Escape immediately after the countdown reaches 0 to enter the GRUB boot menu. + +From there, you can choose an older kernel version (e.g. to recover from a failed kernel install), or change the boot options (e.g. to reset your password or recover from other system issues). + +=== How do I access protected content in browsers (Widevine DRM) [[widevine]] Run `sudo widevine-installer` and follow the prompts. Note that Widevine is third-party software not officially affiliated nor endorsed by the Fedora Project or Asahi Linux. @@ -46,6 +76,27 @@ In addition, Netflix requires manual browser configuration to work. You need to See xref:quick-docs::rpmfusion-setup.adoc[Enabling the RPM Fusion repositories]. +=== How do I download software? [[download-software]] + +A large amount of free and open source software is available in the Fedora repositories. Just install it directly from your desktop environment's software management tool or use `dnf`! + +Some free software is not packaged directly in Fedora, but aarch64 builds may be available officially or from third parties. Look for instructions for **Fedora** users and **aarch64** builds. **AppImage** or **Flatpak** versions may also work as long as they are built for aarch64. + +For example: + +* **Visual Studio Code**: Aarch64 builds are available by following the https://code.visualstudio.com/docs/setup/linux#_rhel-fedora-and-centos-based-distributions[instructions for Fedora users]. +* **Telegram Desktop**: Available in the xref:quick-docs::rpmfusion-setup.adoc[RPM Fusion Free repository]. + +Third-party Fedora builds of software are also available in https://copr.fedorainfracloud.org/[Fedora Copr]. + +Most proprietary software is only available for x86-64 (Intel/AMD) machines and will not run natively on {variant-name}, but often web versions or third-party clients are available that do work: + +* **Discord**: Use the web version, or try https://github.com/ArmCord/ArmCord/releases/latest[ArmCord] (the aarch64 RPM, Flatpak, or AppImage should all work). +* **Spotify**: Follow the instructions in the <> section, and then use the web version. +* **Zoom**: Use the https://app.zoom.us/wc[Progressive Web App]. + +Note: Fedora does not endorse nor offer support for third-party software packages or COPR repositories. Make sure you trust the software and repository you install it from. + == Common issues === Chromium and Chromium/Electron-based apps stop working after an upgrade @@ -56,3 +107,6 @@ Run the following command to resolve the issue: This is caused by an https://bugs.chromium.org/p/chromium/issues/detail?id=1442633[upstream Chromium bug]. This step will be necessary after certain upgrades until the fix is released for the various Chromium-based frameworks and applications built on them. +== Known bugs + +Please see our https://pagure.io/fedora-asahi/remix-bugs/issues[bug tracker] for a list of major known issues.