Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Jump to bottom

Cleanup duplication #449

Closed
wants to merge 4 commits into from
Closed

Cleanup duplication #449

Show file tree
Hide file tree
Changes from 1 commit
Commits
Show all changes
4 commits
Select commit Hold shift + click to select a range
49571c6
Cleanup
sharpenedblade Aug 5, 2023
06521fd
Reword sentence
sharpenedblade Aug 12, 2023
3b92ec3
roadmap: Link to specific parts of the postinstall guide
sharpenedblade Aug 12, 2023
00c4365
Remove deprecated Arch repos
sharpenedblade Aug 12, 2023
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 1 addition & 5 deletions docs/distributions/fedora/faq.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -10,14 +10,10 @@ This may be due to differences between USB-C to USB-A adapters. Try a different

Follow the instructions in the [post-install guide](https://wiki.t2linux.org/guides/postinstall/#setting-up-the-touch-bar). If it still is not working, try updating your macOS instalation.

# My keyboard won't light up (only applies to some hardware)

This sometimes doesn't work on Fedora, we are working on a fix. For now, you can't really do anything about it. This is only affects the internal Apple keyboard, it **will not** affect your external keyboard. This also only occurs on Fedora, the backlight works on all other ditros.

# I get an error about the bootloader when installing

Download the latest ISO, then try again. Make sure you are using the T2 Fedora iso.

# My Wi-Fi stops working after suspending

Try running `sudo modprobe -r brcmfmac && sudo modprobe brcmfmac` in a terminal.
Try running `sudo modprobe -r brcmfmac_wcc && sudo modprobe -r brcmfmac && sudo modprobe brcmfmac` in a terminal.
18 changes: 7 additions & 11 deletions docs/roadmap.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -38,34 +38,30 @@ Arch Linux probably has the most documentation, both officially for the whole pr
t2linux wiki with a really detailed and up to date install guide. On top of that there is also a work in progress `archinstall` script.
Keep in mind however that the whole process is done in the command line.

Manjaro has a more guided install experience, with a graphical installer and multiple prebuilt ISOs for different desktop environments. There are 2 versions of the Manjaro ISO built by different people. JPyke3's version, which is not recommended, and NoaHimesaka1873's which is newer and recommended.

EndeavourOS is an Arch based Linux distribution with a graphical installer. This distribution requires little to no configuration after install.

Ubuntu also has a graphical installer. Additionally, less post configuration work is required as some kernel modules are getting installed automatically.

Fedora also has a prebuilt ISO and a graphical installer. Most things work out of the box, though audio and WiFi generally need to be set up as in the guides below. Then they should work flawlessly.
Fedora also has a prebuilt ISO and a graphical installer. Most things work out of the box.

NixOS has both prebuilt graphical and command line installers. Support for T2 devices is provided in the form of a `nixos-hardware` module.
Importing the module is the only thing you have to do to get your configuration working on your Mac.

If you wish to use another distribution, you can install it normally, also follow the steps to [install the kernel yourself manually](https://wiki.t2linux.org/guides/kernel/) and follow the [post installation steps](https://wiki.t2linux.org/roadmap/#configuring-the-installation).
If you wish to use another distribution, you can install it normally, then also follow the steps to [install the kernel yourself manually](https://wiki.t2linux.org/guides/kernel/) and follow the [post installation steps](https://wiki.t2linux.org/roadmap/#configuring-the-installation).
sharpenedblade marked this conversation as resolved.
Show resolved Hide resolved

## Installing

Follow the [Pre-installation steps](https://wiki.t2linux.org/guides/preinstall) to prepare your Mac to install Linux and head over to the appropriate guide of the distro of your choice as mentioned in that guide.
Follow the [pre-installation steps](https://wiki.t2linux.org/guides/preinstall) to prepare your Mac to install Linux and head over to the appropriate guide of the distro of your choice as mentioned in that guide.

## Configuring the Installation

After successfully booting into your new installation, you will need to configure a few things:
After successfully booting into your new installation, you will need to follow these steps:

- [Performing a basic setup](https://wiki.t2linux.org/guides/postinstall/)
Copy link
Member

Choose a reason for hiding this comment

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

Why have we removed the postinstall link?

Copy link
Contributor Author

@sharpenedblade sharpenedblade Aug 12, 2023 •
edited
Loading

Choose a reason for hiding this comment

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

From the posinstall guide:

Installing a kernel for T2 support

covered in pre-install guide

Add necessary kernel paramaters
Make modules load on boot
Make modules load on early boot

Enabled by default in Fedora and Ubuntu (EDIT: every distro that needs this documents this on its install page, so we can safely remove the link)

Setting up the Touch Bar

This is useful, I will link to it

Wi-Fi and Bluetooth

Completed in the previous step on the roadmap

Network Manager recurrent notifications

Also useful, I will link to it

- [Getting Wi-Fi and Bluetooth to work](https://wiki.t2linux.org/guides/wifi-bluetooth/)
- [Install drivers for the fan (if not working automatically or want to force a certain speed)](https://wiki.t2linux.org/guides/fan/)
- [Configure audio](https://wiki.t2linux.org/guides/audio-config/)
- [Install Wi-Fi and Bluetooth firmware](https://wiki.t2linux.org/guides/wifi-bluetooth/)
- [Install software for the fan (if it isnt working or you want to configure the fan speed)](https://wiki.t2linux.org/guides/fan/)
- [Configure the Startup Manager (optional)](https://wiki.t2linux.org/guides/startup-manager/)
- [Install rEFInd (optional)](https://wiki.t2linux.org/guides/refind/)

You might also want to look into [getting the internal GPU to work](https://wiki.t2linux.org/guides/hybrid-graphics/) if your Mac has two
graphics cards. However, if you don't need it specifically, it's probably best to stick with the dedicated one. If your Mac only has
a single graphics unit, you can ignore this.
a single graphics card, you can ignore this.
Loading