{"id":19621458,"url":"https://github.com/commenthol/macbook-lubuntu-install","last_synced_at":"2026-05-11T12:33:25.229Z","repository":{"id":66111692,"uuid":"118256742","full_name":"commenthol/macbook-lubuntu-install","owner":"commenthol","description":null,"archived":false,"fork":false,"pushed_at":"2018-01-21T19:09:13.000Z","size":6,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":3,"default_branch":"master","last_synced_at":"2025-01-09T11:39:38.596Z","etag":null,"topics":["efi","installer","lubuntu","macbook"],"latest_commit_sha":null,"homepage":null,"language":"Shell","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/commenthol.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2018-01-20T15:48:41.000Z","updated_at":"2018-10-10T20:11:56.000Z","dependencies_parsed_at":"2023-03-05T15:30:42.164Z","dependency_job_id":null,"html_url":"https://github.com/commenthol/macbook-lubuntu-install","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fmacbook-lubuntu-install","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fmacbook-lubuntu-install/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fmacbook-lubuntu-install/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/commenthol%2Fmacbook-lubuntu-install/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/commenthol","download_url":"https://codeload.github.com/commenthol/macbook-lubuntu-install/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":240914984,"owners_count":19878075,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["efi","installer","lubuntu","macbook"],"created_at":"2024-11-11T11:23:11.288Z","updated_at":"2026-05-11T12:33:20.173Z","avatar_url":"https://github.com/commenthol.png","language":"Shell","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Lubuntu install on white Macbook\n\nThis tutorial aims to install a Lubuntu 17.10 on a Macbook3,1 using live CD via usb-stick.\nMy major problem was running the desktop 32bit ISO which does not fit on a CD. This may also work on an old MacMini1,1\n\n## requisites\n\n- VM Host http://virtualbox.org\n- Live Lubuntu ISO Image\n- USB-Stick \u003e= 2GB\n\n## start live CD\n\n1. Download Live CD - I'm using [Lubuntu 17.10][Lubuntu 17.10].\n2. Start VirtualBox and create new VM mounting ISO-Image\n3. Start Live-CD VM\n   - For Lubuntu 17.10 it might be necessary to start with \"nomodeset\" option\n     Press \"F6\" Other Options and set \"nomodeset\"\n\n## format usb-stick\n\nIn Live-CD open terminal wit `ctrl + alt + t`\n\n1. `sudo gparted`\n2. Select USB-Drive (e.g. /dev/sda)\n3. Menu:Device \u003e Create Partition Table \u003e Dialog:Warning This will ERASE... \u003e Dropdown:gpt \u003e Button:Apply\n4. Menu:Partition \u003e New \u003e Filesystem: Dropdown:fat32 ; Partition Name: GRUB2EFI \u003e OK \u003e Menu:Edit \u003e Apply all Operations\n5. Exit `gparted`\n\n## prepare grub efi\n\nStill in Live-CD...\n\n1. Download the `grub.sh`, `grub.cfg` together with `post.sh` script in same folder.\n2. Make sure that your usb-stick is device `/dev/sda` and mounted under `/media/lubuntu/GRUB2EFI`.\n   - If this is not the case edit the `grub.sh` script.\n3. Run `sh grub.sh` from the terminal.\n4. If using a different ISO-Image you may need to change grub.cfg in `EFI/BOOT` folder on the usb-stick.\n5. Switch to your Host-OS and copy the iso image to the `/iso` folder\n\n  Your stick should contain these files now.\n  ````\n  /media/lubuntu/GRUB2EFI\n  ├── EFI\n  │   └── BOOT\n  │       ├── bootx64.efi\n  │       ├── bootia32.efi\n  │       └── grub.cfg\n  ├── iso\n  │   └── lubuntu-17.10.1-desktop-i386.iso\n  └── post.sh\n  ````\n\n## macbook2 prepare\n\n1. Boot into OSX and open \"Disk Utility\"\n2. Repartition your Harddisk to decrease your OSX Partition. Create a new one for Lubuntu\n   - Check here on how to do \u003chttp://www.peachpit.com/articles/article.aspx?p=1395749\u003e\n3. Download ReFind \u003chttps://sourceforge.net/projects/refind/files/0.11.2/refind-bin-0.11.2.zip/download\u003e\n   - Unzip and run `./refind-install`\n   - Documentation is at \u003chttp://www.rodsbooks.com/refind/installing.html#osx\u003e\n4. Shutdown OSX\n5. Insert usb-stick in macbook and boot holding the `alt` key.\n6. Select the \"EFI Boot\" with USB-Icon (right-most)\n7. Boot into Live CD - this may take some time... make credit to USB1\n\n## install Lubuntu\n\n1. Click on \"Install Lubuntu 17.10\"\n   - You may check \u003chttps://help.ubuntu.com/community/Lubuntu/InstallingLubuntu\u003e on howto install\n   - Do **NOT** unmount partitions that are in use (it's your usb-stick we need for installation)\n2. Run the partiioning using your second partition you peviously created under OSX.\n   - Note down the device name lubuntu gets installed. E.g. `/dev/sda3`\n   - Run the installer - it will stop with an error stating that grub can`t be installed\n   - Do **NOT shutdown** the computer.\n3. Grub bootloader installation using `post.sh` script.\n   - Check your partitions first with `sudo fdisk -l /dev/sda`\n   - Make sure your Linux filesystem is at `/dev/sda3`. If this is not the case edit `post.sh` and change the line `linux=${disk}3` accordingly. Use `cp /isodevice/post.sh .`\n   - Run `sh /isodevice/post.sh install`\n\n## postinstall\n\n- Install additional drivers...\n  - Broadcom Wifi\n  - Intel Microcode\n- You may change the default behavior for function keys\n  - See details https://help.ubuntu.com/community/AppleKeyboard\n  - TLTR\n    ```bash\n    echo options hid_apple fnmode=2 | sudo tee -a /etc/modprobe.d/hid_apple.conf\n    sudo update-initramfs -u -k all\n    ```\n- isight http://bersace03.free.fr/ift/\n  ```bash\n  sudo apt install isight-firmware-tools\n  # mount Macintosh HD from file manager\n  sudo ift-extract -a /media/$USER/Macintosh\\ HD/System/Library/Extensions/IOUSBFamily.kext/Contents/PlugIns/AppleUSBVideoSupport.kext/Contents/MacOS/AppleUSBVideoSupport\n  ```\n- There is an issue with [drm:drm_atomic_helper_commit_cleanup_done [drm_kms_helper]] *ERROR* [CRTC:26:pipe A] flip_done timed out in `dmesg`\n  - check https://bbs.archlinux.org/viewtopic.php?pid=1689914#p1689914\n  - in `/etc/default/grub` add\n    ```bash\n    GRUB_CMDLINE_LINUX_DEFAULT=\"acpi_osi=Linux acpi_backlight=vendor video=SVIDEO-1:d\"\n    ```\n    then run `update-grub`\n\n## License\n\n- Content is licensed under [CC0](http://creativecommons.org/publicdomain/zero/1.0/).\n- Source code is licensed under [Unlicense](http://unlicense.org/)\n\n## References\n\n- http://lubuntu.org/\n- https://askubuntu.com/questions/395879/how-to-create-uefi-only-bootable-usb-live-media\n- https://ubuntuforums.org/showthread.php?t=2276498\n- https://help.ubuntu.com/community/UEFIBooting#Building_GRUB2_.28U.29EFI\n- http://howtoubuntu.org/how-to-repair-restore-reinstall-grub-2-with-a-ubuntu-live-cd\n- [ReFind][ReFind]\n\n[Lubuntu 17.10]: http://cdimage.ubuntu.com/lubuntu/releases/17.10.1/release/lubuntu-17.10.1-desktop-i386.iso\n[ReFind]: http://www.rodsbooks.com/refind\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommenthol%2Fmacbook-lubuntu-install","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fcommenthol%2Fmacbook-lubuntu-install","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fcommenthol%2Fmacbook-lubuntu-install/lists"}