Difference between revisions of "Pinebook Pro Software Releases"

From PINE64
Jump to navigation Jump to search
(added Slackware Linux)
(49 intermediate revisions by 22 users not shown)
Line 1: Line 1:
= Linux OS Image Releases =
= Linux OS Image Releases =
For information on how to install these images onto your device, please see the [[NOOB]] Page, which includes information on writing images to the device eMMC or an SD card.
For information on how to install these images onto your device, please see the [[NOOB]] Page, which includes information on writing images to the device eMMC or an SD card


If Manjaro is installed on the eMMC you may experience issues booting different installations from SD card. [https://gitlab.manjaro.org/snippets/490 List of known affected distros and workaround].
== Manjaro ARM ==
[[File:Manjaro.png|right|100px]]
 
The Manjaro project offers a mainline kernel with patches and modules to support PBPro hardware. To learn more about Manjaro please visit [https://forum.manjaro.org/c/arm/ Manjaro Forum]. You can follow the ongoing discussion about Manjaro on the [https://forum.pine64.org/showthread.php?tid=8207 PINE64 forum].
All images boot from both SD card and the internal eMMC module.
 
=== Manjaro ARM with KDE Plasma ===
 
* [https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-kde-plasma/ Direct download from Manjaro]
 
=== Manjaro ARM with Xfce ===
 
* [https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-xfce/ Direct download from Manjaro]
 
=== Manjaro ARM with Gnome ===


== elementary OS ==
* [https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-gnome/ Direct download from Manjaro]
[[File:elementaryLogo.png|right|100px]]


=== elementary OS 6 [microSD/eMMC boot] ===
=== Manjaro ARM with Sway ===
* [https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-sway/ Direct download from Manjaro]


* Full version of elementary OS optimized for Pinebook Pro
=== Manjaro ARM with no desktop ===
* Experimental [https://builds.elementary.io/ “Early Access” build of elementary OS 6] (which has not been released as stable)
* [https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-minimal/ Direct download from Manjaro]
** Size: ~1.2 GB (varies since images are built daily)
* Polished first-run setup which helps you create a user before logging in
* Downloading, installation, etc. details at the [https://github.com/elementary/os/wiki/Pinebook-Pro elementary OS Wiki]


== Armbian ==
[[File:armbian.png|right|100px]]
As of Nov. 3rd, 2021, Pinebook Pro has No official support (CSC) from Armbian.


==Kali Linux==
To find out more about Armbian and available options please visit their [https://www.armbian.com/pinebook-pro/ site].
[[File:Kali.jpeg|right|100px]]
 
=== Armbian Ubuntu Focal with Xfce (mainline kernel) ===
 
Armbian provides a mainline kernel build images for Ubuntu Focal with Xfce Desktop. It boots from microSD card and from eMMC.
 
'''Download location'''
 
Get the latest image here: [https://dl.armbian.com/pinebook-pro/Focal_current_desktop Armbian's Pinebook Pro Ubuntu Focal Xfce]
 
=== Armbian Ubuntu Focal with Gnome (mainline kernel) ===
 
Armbian provides a mainline kernel build images for Ubuntu Focal with GNOME Desktop. It boots from microSD card and from eMMC.
 
'''Download location'''


=== Kali Linux prebuilt OS images for Pinebook Pro [SD/eMMC boot]===
Get the latest image here: [https://redirect.armbian.com/region/NA/pinebook-pro/Focal_current_gnome]
* Official pre-built OS images of Kali Linux for the Pinebook Pro featuring all tools you'd expect from the distribution.
* DD image (for 8GB microSD card /16GB eMMC module and above):
** [https://www.offensive-security.com/kali-linux-arm-images/ Direct download latest images from Offensive Security's website]
** size: 2.0GB
* Login with
** username: kali
** password: kali


=== Armbian Ubuntu Focal with Xfce (legacy kernel) ===


== Arch Linux ==
Armbian provides a legacy kernel 4.4 build images for Ubuntu Focal with Xfce Desktop. It boots from microSD card and from eMMC.
[[File:Archlinux-logo.png|right|100px]]


=== Arch Linux ARM install image [microSD/USB Boot] ===
'''Download location'''
* archiso image customized for Arch Linux ARM on the Pinebook Pro
* DD image (for 1GB or larger microSD card/USB stick):
** [https://github.com/nadiaholmquist/archiso-pbp/releases Direct download for latest releases from GitHub]
** size: 579MB
* Automatic login as root
* Make sure to thoroughly read the [https://github.com/nadiaholmquist/archiso-pbp/blob/master/README.md readme] and [https://github.com/nadiaholmquist/archiso-pbp/blob/master/FAQ.md FAQ], otherwise follow the normal Arch installation guide.


Get the latest image here: [https://dl.armbian.com/pinebook-pro/Focal_legacy_desktop Armbian's Pinebook Pro Ubuntu Focal Xfce]


== Manjaro ARM ==
=== Armbian Debian Buster with Xfce (legacy kernel) ===
[[File:Manjaro.png|right|100px]]


* The Manjaro project offers a mainline kernel with patches and modules to support PBPro hardware in two flavors. Both provide DD images and installer images (DD to SD card which will then install to eMMC when booted).
Armbian provides a legacy kernel 4.4 build images for Debian Buster with Xfce Desktop. It boots from microSD card and from eMMC.
* To learn more about Manjaro please visit [https://forum.manjaro.org/tags/manjaroarm Manjaro Forum]


=== Manjaro ARM with KDE (Plasma) desktop [microSD / eMMC Boot] ===
'''Download location'''


* [https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-kde-plasma/ Direct download from Manjaro]  (microSD image only)
Get the latest image here: [https://dl.armbian.com/pinebook-pro/Buster_legacy_desktop Armbian's Pinebook Pro Debian Buster Xfce]
* [https://osdn.net/projects/manjaro-arm/storage/pbpro/kde-plasma/ Direct download from osdn.net] (both microSD and emmc-installer images)


=== Manjaro ARM with GTK (XFCE) desktop [microSD / eMMC Boot] ===
=== Armbian Ubuntu Bionic with Xfce (legacy kernel) ===


* [https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-xfce/ Direct download from Manjaro]
Armbian provides a legacy kernel 4.4 build images for Ubuntu Bionic with Xfce Desktop. It boots from microSD card and from eMMC.
* [https://osdn.net/projects/manjaro-arm/storage/pbpro/xfce/ Direct download from osdn.net]


=== Manjaro ARM with i3 tiling window manager [microSD / eMMC Boot] ===
'''Download location'''


* [https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-i3/ Direct download from Manjaro]
Get the latest image here: [https://dl.armbian.com/pinebook-pro/Bionic_legacy_desktop Armbian's Pinebook Pro Ubuntu Bionic Xfce Desktop download site]
* [https://osdn.net/projects/manjaro-arm/storage/pbpro/i3/ Direct download from osdn.net]


=== Manjaro ARM with Sway tiling window manager [microSD / eMMC Boot] ===
== Twister OS ==
[[File:Twister_OS.png|right|100px]]


* [https://osdn.net/projects/manjaro-arm/storage/pbpro/sway/ Direct download from osdn.net]
Twister OS Armbian-Reforged with Xfce. It boots from microSD card and from eMMC. For more information on Twister OS, please visit this [https://twisteros.com/ official site]. You can follow the ongoing discussion about Twister OS on the [https://forum.pine64.org/showthread.php?tid=12192 PINE64 forum].


=== Manjaro ARM installer ===
'''Installation'''


The [https://gitlab.manjaro.org/manjaro-arm/applications/manjaro-arm-installer manjaro-arm-installer] script is intended to install Manjaro ARM directly to SD/eMMC cards without the need for images (including LXQT, Mate & CuboCore editions, as well as full disk encryption). Running on a Linux x86 computer, it can install Manjaro ARM directly to an empty eMMC using an eMMC to USB adapter. The script can also be run from SD to install an image to the eMMC.
* After flashing image, edit /boot/armbianEnv.txt, replace the dtb name with <code>rk3399-pinebook-pro.dtb</code>


'''Download location'''


== OpenSUSE ==
Get the latest image here: [https://twisteros.com/twisterarmbian.html Direct download latest images from Twister OS's website] (size: 2.8GB)
[[File:Opensuse1.png|right|100px]]


=== OpenSUSE XFCE OS Image [microSD / eMMC Boot] ===
'''Password'''
* This image contains an install of openSUSE tumbleweed with XFCE desktop environment.
* To learn more about OpenSUSE please visit the [https://www.opensuse.org/ official website].
* Pinebook Pro build instructions can be found [https://github.com/smithmcgriff/opensuse-on-pinebookpro-gnome here]
* DD image (for 16GB microSD card / eMMC module and above)
** [https://sourceforge.net/projects/opensuse-on-pinebookpro/files/Rel_1/ Direct download latest release build from SourceForge]
* login with:
** username: root
** password: linux


=== OpenSUSE GNOME 3 OS Image [microSD / eMMC Boot] ===
asdasd
* This image contains an install of openSUSE tumbleweed with GNOME 3 desktop environment.
* To learn more about OpenSUSE please visit the [https://www.opensuse.org/ official website].
* Pinebook Pro build instructions can be found [https://github.com/smithmcgriff/opensuse-on-pinebookpro-gnome here]
* DD image (for 16GB microSD card / eMMC module and above)
** [https://sourceforge.net/projects/opensuse-on-pinebookpro/files/Rel_1/ Direct download latest release build from SourceForge]
* login with:
** username: tux
** password: susepassword


== Fedora ==
== Fedora ==
[[File:fedora1.png|right|100px]]
[[File:fedora1.png|right|100px]]


=== Fedora Official ===
Using this [https://nullr0ute.com/2021/05/fedora-on-the-pinebook-pro/ blog post] it is now possible to run Official Fedora on the Pinebook Pro.
'''Notes'''
Upstream Fedora uses  SPI flash on the Pinebook Pro to manage uboot.
=== Fedora 32 with Cinnamon ===
This image contains an install of Fedora with [https://cinnamon-spices.linuxmint.com/ Cinnamon] desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the [https://getfedora.org/ official website].
'''Download location'''


=== Fedora 32 Cinnamon Desktop OS Image [microSD / eMMC Boot] ===
Get the latest image here: [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Cinnamon-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]
* This image contains an install of Fedora with [https://cinnamon-spices.linuxmint.com/ Cinnamon] desktop environment.
* To learn more about Fedora please visit the [https://getfedora.org/ official website].
* DD image (for 12GB microSD card / eMMC module and above)
** [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Cinnamon-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]
* login with:
** username: root
** password: fedora


=== Fedora 32 KDE Desktop OS Image [microSD / eMMC Boot] ===
'''Username and password'''
* This image contains an install of Fedora with [https://kde.org/ KDE aka Plasma] desktop environment.
* To learn more about Fedora please visit the [https://getfedora.org/ official website].
* DD image (for 12GB microSD card / eMMC module and above)
** [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-KDE-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]
* login with:
** username: root
** password: fedora


=== Fedora 32 Xfce Desktop OS Image [microSD / eMMC Boot] ===
root/fedora
* This image contains an install of Fedora with [https://xfce.org/ xfce] desktop environment.
* To learn more about Fedora please visit the [https://getfedora.org/ official website].
* DD image (for 12GB microSD card / eMMC module and above)
** [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Xfce-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]
* login with:
** username: root
** password: fedora


=== Fedora 32 Workstation OS Image [microSD / eMMC Boot] ===
=== Fedora 32 with KDE ===
* This image contains an install of Fedora with [https://www.gnome.org/gnome-3/ GNOME 3] desktop environment.
* To learn more about Fedora please visit the [https://getfedora.org/ official website].
* DD image (for 12GB microSD card / eMMC module and above)
** [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Workstation-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]
* login with:
** username: root
** password: fedora


This image contains an install of Fedora with [https://kde.org/ KDE aka Plasma] desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the [https://getfedora.org/ official website].


== Armbian ==
'''Download location'''
[[File:armbian.png|right|100px]]
 
Get the latest image here: [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-KDE-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]


* To find out more about Armbian and available options please visit their [https://www.armbian.com/pinebook-pro/ site]
'''Username and password'''
* DD image to microSD card or eMMC module and boot. Highly recommend using [https://etcher.io/ Etcher]


=== Armbian Ubuntu Focal XFCE Desktop mainline kernel [microSD / eMMC Boot]  ===
root/fedora
* Armbian provides a mainline kernel build images for Ubuntu Focal with XFCE Desktop
* DD image (for 8GB micoSD card or eMMC Module and above)
** [https://dl.armbian.com/pinebook-pro/Focal_current_desktop Armbian's Pinebook Pro Ubuntu Focal XFCE Desktop download site]


=== Armbian Ubuntu Focal XFCE Desktop legacy kernel [microSD / eMMC Boot]  ===
=== Fedora 32 with Xfce===
* Armbian provides a legacy kernel 4.4 build images for Ubuntu Focal with XFCE Desktop
* DD image (for 8GB microSD card or eMMC Module and above)
** [https://dl.armbian.com/pinebook-pro/Focal_legacy_desktop Armbian's Pinebook Pro Ubuntu Focal XFCE Desktop download site]


=== Armbian Debian Buster XFCE Desktop legacy kernel [microSD / eMMC Boot] ===
This image contains an install of Fedora with [https://xfce.org/ Xfce] desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the [https://getfedora.org/ official website].
* Armbian provides a legacy kernel 4.4 build images for Debian Buster with XFCE Desktop
* DD image (for 8GB micoSD card or eMMC Module and above)
** [https://dl.armbian.com/pinebook-pro/Buster_legacy_desktop Armbian's Pinebook Pro Debian Buster XFCE Desktop download site]


=== Armbian Ubuntu Bionic XFCE Desktop legacy kernel [microSD / eMMC Boot]  ===
'''Download location'''
* Armbian provides a legacy kernel 4.4 build images for Ubuntu Bionic with XFCE Desktop
* DD image (for 8GB micoSD card or eMMC Module and above)
** [https://dl.armbian.com/pinebook-pro/Bionic_legacy_desktop Armbian's Pinebook Pro Ubuntu Bionic XFCE Desktop download site]


Get the latest image here: [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Xfce-Desktop-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]


== AOSC ==
'''Username and password'''
[[File:aosc.png|right|100px]]


* To learn more about AOSC, please visit the official [https://aosc.io/ AOSC website]
root/fedora
* AOSC using LZ4 compression algorithm, please visit the [https://github.com/lz4/lz4 LZ4 github site] for utility
* 8GB microSD card or eMMC module and above
* Login with
** username: aosc
** password: anthon
=== AOSC KDE Community Build Image [microSD and eMMC Boot] ===
* [https://releases.aosc.io/os-arm64/rockchip64/kde/pinebook-pro/ Direct download from AOSC]


=== AOSC GNOME Community Build Image [microSD and eMMC Boot] ===
=== Fedora 32 with Gnome ===
* [https://releases.aosc.io/os-arm64/rockchip64/gnome/pinebook-pro/ Direct download from AOSC]


=== AOSC MATE Community Build Image [microSD and eMMC Boot] ===
This image contains an install of Fedora with [https://www.gnome.org/gnome-3/ GNOME 3] desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the [https://getfedora.org/ official website].
* [https://releases.aosc.io/os-arm64/rockchip64/mate/pinebook-pro/ Direct download from AOSC]


=== AOSC Cinnamon Community Build Image [microSD and eMMC Boot] ===
'''Download location'''
* [https://releases.aosc.io/os-arm64/rockchip64/cinnamon/pinebook-pro/ Direct download from AOSC]


=== AOSC XFCE Community Build Image [microSD and eMMC Boot] ===
Get the latest image here: [https://builds.armdevelopers.com/pinebook-pro/releases/dev/Fedora32-Workstation-202009.0.pinebook-pro.img.xz Fedora 32 Pinebook Pro Image]
* [https://releases.aosc.io/os-arm64/rockchip64/xfce/pinebook-pro/ Direct download from AOSC]


=== AOSC LXDE Community Build Image [microSD and eMMC Boot] ===
'''Username and password'''
* [https://releases.aosc.io/os-arm64/rockchip64/lxde/pinebook-pro/ Direct download from AOSC]


== Twister OS ==
root/fedora
[[File:Twister_OS.png|right|100px]]


=== Twister OS Armbian-Reforged XFCE Dsktop beta images [SD boot]===
== Arch Linux ARM ==
* For more infomation on Twister OS, please visit this {https://twisteros.com/ official site]
[[File:Archlinux-logo.png|right|100px]]
* You can follow the ongoing discussion about Twister OS on the PINE64 forum (https://forum.pine64.org/showthread.php?tid=12192)
* After flashing image with Etcher, edit /boot/armbianEnv.txt, replace the dtb name with rk3399-pinebook-pro.dtb.
* DD image (for 16GB microSD card /16GB eMMC module and above):
** [https://twisteros.com/twisterarmbian.html Direct download latest images from Twister OS's website]
** size: 2.8GB
* Login with
** password: asdasd


=== Twister OS Monka-Manjaro XFCE Dsktop beta images [SD boot]===
=== Official Installation ===
* For more infomation on Twister OS, please visit this {https://twisteros.com/ official site]
See [[Installing Arch Linux ARM On The Pinebook Pro]] for instructions on how to install the official Arch Linux ARM.
* You can follow the ongoing discussion about Twister OS on the PINE64 forum (https://forum.pine64.org/showthread.php?tid=12192)
* After flashing image with Etcher, edit /boot/armbianEnv.txt, replace the dtb name with rk3399-pinebook-pro.dtb.
* DD image (for 16GB microSD card /16GB eMMC module and above):
** [https://drive.google.com/file/d/1I0yHIDfezqnz1jdphJ4gooWbGtNw0ArW/view?usp=sharing Direct download latest images from Google Drive]
** size: 8.9GB
* Login with
** username: pi
** password: root


=== Customized Premade Image ===
Arch Linux ARM root filesystem customized for the Pinebook Pro using Manjaro kernel. Instructions are included for installation on microSD card, eMMC module and NVME SSD.


== Debian Desktop ==
'''Download location'''
[[File:debian.png|right|100px]]


=== Debian Desktop Community Build Image [microSD to eMMC] by mrfixit2001 ===
[https://github.com/SvenKiljan/archlinuxarm-pbp/releases/latest Get the latest image from GitHub] (size: 591 MB).
* This was previously the default operating system for the Pinebook Pro
* Includes desktop, Firefox browser, and LibreOffice
* DD image (for 8GB microSD card / 16GB eMMC module and above):
** [https://github.com/mrfixit2001/debian_desktop/releases/download/191226/pinebookpro-debian-desktop-mrfixit191226.img.xz Direct download release build 191226 from mrfixit2001's github]
*** MD5 (img file): 59838c1518b8b6da86a00d38b31ae904
*** File Size: 1.19GB
* Login with
** username: rock
** password: rock


== Ubuntu 20.04 Focal Fossa MATE / GNOME ==
'''Installation'''
[[File:UbuntuLogo.png|right|100px]]


=== Ubuntu 20.04 Focal Fossa MATE and GNOME Community Builds [microSD/ eMMC Boot] by ayufan ===
Make sure to thoroughly read the [https://github.com/SvenKiljan/archlinuxarm-pbp/blob/main/README.md readme], [https://github.com/SvenKiljan/archlinuxarm-pbp/blob/main/README.md installation instructions] and [https://github.com/SvenKiljan/archlinuxarm-pbp/blob/main/FAQ.md FAQ].
* Desktop Images featurng a standard Ubuntu suite of software to get you started.  
* DD image (for 8GB microSD card /16GB eMMC module and above):
** [https://github.com/ayufan-rock64/linux-build/releases Direct download for latests releases and pre-releases on ayufan's github]
** size: 1.06GB
* Login with
** username: rock64
** password: rock64 (must be changed on initial boot)


== Ubuntu 18.04 Bionic Beaver LXDE ==
'''Username and password'''
[[File:lxde.png|right|100px]]


=== Ubuntu 18.04 Bionic Beaver LXDE Community Build Image by ayufan [microSD and eMMC Boot] ===
The default Arch Linux ARM user credentials.
* Included LXDE Desktop, Firefox Browser, and LibreOffice Suite
* DD image (for 8GB microSD card /16GB eMMC module and above):
** [https://github.com/ayufan-rock64/linux-build/releases/download/0.9.14/bionic-lxde-pinebookpro-0.9.14-1159-armhf.img.xz Direct download release build 0.9.14 from ayufan's github]
** MD5 (XZ file): B74E8366615DAE89AEB5CC878F2B316B
** size: 763MB
* Login with
** username: rock64
** password: rock64


== Bionic Mate ==
Username: alarm
[[File:mate.png|right|100px]]


=== Bionic Mate Community Build Image [microSD Boot] by ayufan ===
Password: alarm
* Included Mate Desktop, Firefox Browser, and LibreOffice Suite
* DD image (for 8GB microSD card / 16GB eMMC module and above):
** [https://github.com/ayufan-rock64/linux-build/releases/download/0.9.14/bionic-mate-pinebookpro-0.9.14-1159-armhf.img.xz Direct download release build 0.9.14 from ayufan's github]
** MD5 (XZ file): 5F60494B9248570FAF5853860A26B489
** size: 1.06GB
* Login with
** username: rock64
** password: rock64


The password for the root account is 'root'.


== postmarketOS ==
== postmarketOS ==
[[File:PostmarketOS logo.png|right|100px]]
[[File:PostmarketOS logo.png|right|100px]]


===Official postmarketOS build [microSD/ eMMC Boot] ===
Official postmarketOS build with the GNOME desktop for the Pinebook Pro. It boots from microSD card and from eMMC.
* Official postmarketOS build with the GNOME desktop for the Pinebook Pro.  
 
* DD image (for 8GB microSD card /16GB eMMC module and above):
'''Download location'''
** [http://images.postmarketos.org/pinebookpro/ Direct download latest images from postmarketOS]
 
** size: 400MB
Get the latest image here: [https://images.postmarketos.org/bpo/edge/pine64-pinebookpro/ Direct download latest images from postmarketOS] (size: 400 MB)
* Login with
 
** username: demo
'''Username and password'''
** password: demo OR 147147
 
demo/demo
 
or:
 
demo/147147
 
==Kali Linux==
[[File:Kali.jpeg|right|100px]]
 
=== Kali Linux prebuilt OS images for Pinebook Pro===
 
Official pre-built OS images of Kali Linux for the Pinebook Pro featuring all tools you'd expect from the distribution. It boots from microSD card and from eMMC.
 
'''Download location'''
 
Get the latest image here: [https://www.offensive-security.com/kali-linux-arm-images/ Direct download latest images from Offensive Security's website] (size: 2.0 GB)
 
'''Username and password'''


kali/kali


== Q4OS ==
== Q4OS ==
[[File:q4os.png|right|100px]]
[[File:q4os.png|right|100px]]


=== Q4OS Test Build Image [microSD / eMMC Boot] ===
Q4OS is advertised as a 'fast and powerful operating system based on the latest technologies while offering highly productive desktop environment'. It boots from microSD card and from eMMC. To learn more please visit the [https://forum.pine64.org/showthread.php?tid=8385 PINE64 forum] or official [https://q4os.org/index.html Q4OS website].
* Q4OS is advertised as a 'fast and powerful operating system based on the latest technologies while offering highly productive desktop environment'
* To learn more please visit the [https://forum.pine64.org/showthread.php?tid=8385 PINE64 forum] or official [https://q4os.org/index.html Q4OS website]
* DD image (for 8GB microSD card / eMMC module and above)
** [https://sourceforge.net/projects/q4os/files/testing/ Direct download latest release build from SourceForge]
*  User account and password are created on first run


'''Download location'''


==Recalbox==
Get the latest image here: [https://sourceforge.net/projects/q4os/files/stable/ Direct download latest release build from SourceForge]
[[File:RB.png|right|100px]]


=== Recalbox for Pinebook Pro [SD/eMMC boot]===
'''Username and password'''
* Recalbox is a retrogaming Linux distribution allowing for emulation of all classic videogame systems.
* DD image (for 8GB microSD card /16GB eMMC module and above):
** [https://github.com/mrfixit2001/recalbox-rockchip/releases Direct download latest images from MrFixit's gitbub]
** size: 450MB
* SSH Login
** username: root
** password: recalboxroot


= BSD OS Image Release =
User account and password are created on first run.


==NetBSD==
== DietPi ==
[[File:netbsd.png|right|100px]]
[[File:dietpi.png|right|100px]]
 
* DietPi is a '''lightweight''', yet '''easy to setup''' and '''feature-rich''' Linux distribution, based on '''Debian'''.
* To find out more about DietPi, please visit the [https://dietpi.com/docs/ official documentation].
* Discuss the Pinebook build on the [https://forum.pine64.org/showthread.php?tid=14061 PINE64 forum thread].
* DD image (for 4 GiB micro SD card and above)
** [https://dietpi.com/downloads/images/DietPi_PinebookPro-ARMv8-Bullseye.7z Direct download from dietpi.com]
* Login with
** Username: '''root'''
** Password: '''dietpi'''
 
== openSUSE ==
[[File:opensuse-distribution.png|right|100px]]
 
'''Download location'''
 
Get the latest openSUSE Tumbleweed images for Pinebook Pro here: [https://en.opensuse.org/HCL:Pinebook-Pro-RK3399]


=== NetBSD [microSD /eMMC Boot] ===
Credits to [https://bugzilla.opensuse.org/show_bug.cgi?id=1194491]
* To learn more about NetBSD please visit [https://www.netbsd.org/ NetBSD main page]  
Step 1. Flash Tow-Boot[https://github.com/Tow-Boot/Tow-Boot] to SPI
* DD image to microSD card or eMMC module. Highly recommend using [https://etcher.io/ Etcher]
Step 2. Flash openSUSE image to sd card & insert it
** [http://www.armbsd.org/arm/ Direct download from NetBSD]
Step 3. When it loads grub, press e and add the following line:
* Console and SSH default login:
** username: root
** password: [none]
* Instructions concerning enabling SSH can be found [https://www.netbsd.org/docs/guide/en/chap-boot.html#chap-boot-ssh here]


==OpenBSD==
devicetree /boot/dtb/rockchip/rk3399-pinebook-pro.dtb
[[File:Puffy_mascot_openbsd.png|right|100px]]


=== OpenBSD ===
Press ctrl + x to boot
* To learn more about OpenBSD, please visit [https://www.openbsd.org/ OpenBSD main page]
* ARM64 images, (including support for Pinebook Pro), can be found here [https://www.openbsd.org/arm64.html  OpenBSD arm64]


Work : display, wifi
Not tested : bluetooth
Doesn't work : audio


= Chromium OS Image Release =
You may build rpms and see if it fix issues from this repository: [https://github.com/bengtfredh/pinebook-pro-copr]


== FydeOS ==
== FydeOS ==
[[File:FydeOS.png|right|100px]]
An operating system based on the Chromium Project


To learn more about FydeOS please visit [https://releases.fydeos.io/11.2/pinebook-pro]
https://fydeos.io/download/device/pinebook-pro


* You can follow the ongoing discussion about FydeOS on the PINE64 forum (https://forum.pine64.org/showthread.php?tid=12201)
= BSD =
* DD image to microSD card or eMMC module. Highly recommend using [https://etcher.io/ Etcher]
** [https://fydeos.com/download/ Direct download latest release build from FydeOS by select "FydeOS for You Pinebook Pro"]


== ChromiumOS Community Build Image by ayufan [microSD and eMMC Boot] ==
==NetBSD==
[[File:chromium.jpg|right|100px]]
[[File:netbsd.png|right|100px]]


* DD image (for 8GB microSD card/16GB eMMC module and above)
The image boots from microSD card and from eMMC. To learn more about NetBSD please visit [https://www.netbsd.org/ NetBSD main page]
** [https://github.com/ayufan-rock64/chromiumos-build/releases/download/R77-12371.7.104.g78f88d6/chromiumos-rockpro64-R77-12371.7.104.g78f88d6.img.xz Direct download R77 build from ayufan's github]
** MD5 (XZ file): 7B747B6D2B041C5C0C6434DDB524DB66
** size: 387MB


'''Download location'''


= Android Image Releases =
Get the latest image here: [http://www.armbsd.org/arm/ Direct download from NetBSD]


== Android 7.1 microSD ==
'''Installation'''
[[File:android_7.png|right|100px]]


=== Stock Android for DD method [micro SD Boot] [20190918] ===
Instructions concerning enabling SSH can be found [https://www.netbsd.org/docs/guide/en/chap-boot.html#chap-boot-ssh here].
* Production floor testing image
* Use 'dd' to write the image to the microSD card and boot. Using [https://www.balena.io/etcher/ Etcher] or another specialized SD writing tool is preferred.
* Please allow 3-5 minutes boot up time on first time for initialization
* DD image for 8GB microSD card
** [http://files.pine64.org/os/PinebookPro/Android/PinebookPro_dd_20190918_stock_android_7.1_sdboot-8GB.img.gz Direct download from pine64.org]
*** MD5 (GZip file): 207BCBFFF59C1AB29F8ADC63D426EACB
*** File Size: 562MB
* DD image for 16GB microSD card
** [http://files.pine64.org/os/PinebookPro/Android/PinebookPro_dd_20190918_stock_android_7.1_sdboot-16GB.img.gz Direct download from pine64.org]
*** MD5 (GZip file): B1FC25A2F896F5C6B4B85EA6D1E75CDA
*** File Size: 571MB
* DD image for 32GB microSD card
** [http://files.pine64.org/os/PinebookPro/Android/PinebookPro_dd_20190918_stock_android_7.1_sdboot-32GB.img.gz Direct download from pine64.org]
*** MD5 (GZip file): A07E2C2A2798A77375268E423A30048A
*** File Size: 589MB
* DD image for 64GB microSD card
** [http://files.pine64.org/os/PinebookPro/Android/PinebookPro_dd_20190918_stock_android_7.1_sdboot-64GB.img.gz Direct download from pine64.org]
*** MD5 (GZip file): D7626BD50443A88AEB9254C88C575284
*** File Size: 627MB


=== Stock for RK Flash tool [SD Boot] [20190427] ===
'''Username and password'''
* Please unzip first and then using [http://files.pine64.org/os/ROCK64/android/SDDiskTool_v1.57.zip Rockchip SD Firmware Tool ver 1.57] to flash in, please remember to select "SD boot" option.
** [http://files.pine64.org/os/PinebookPro/Android/PinebookPro_20190918_stock_android_7.1_sdboot.img.gz Direct download from pine64.org]
** MD5 (GZip file): DBA2109C393F514132EC8D5FB6E8EBE2
** File Size: 555MB


== Android 7.1 eMMC ==
root/(none)
=== Stock Android for DD method [eMMC Boot] [20190807] ===
* Production floor testing image
* Please allows some time (around 5 minutes) for the initialization process on 1st boot
* DD image for 64GB eMMC Module
** [http://files.pine64.org/os/PinebookPro/Android/PinebookPro_dd_20190807_stock_android_7.1_emmcboot-64GB.img.gz Direct download from pine64.org]
*** MD5 (GZip file): 314583B550AFF0F424D9997D237D7046
*** File Size: 634MB
* DD image for 128GB eMMC Module
** [http://files.pine64.org/os/PinebookPro/Android/PinebookPro_dd_20190807_stock_android_7.1_emmcboot-128GB.img.gz Direct download from pine64.org]
*** MD5 (GZip file): 16942B8F9EEE79B81FADDB09AF7E2E80
*** File Size: 700MB


=== Stock for RK Flash tool [eMMC Boot] [20190807] ===
==OpenBSD==
* Please unzip first and then using [http://files.pine64.org/os/ROCK64/android/AndroidTool_Release_v2.63.zip Rockchip Android tool ver 2.63] to flash in
[[File:Puffy_mascot_openbsd.png|right|100px]]
* The OTG port located at USB type-C connector, needs USB type A to type C cable.
 
* [http://wiki.pine64.org/index.php/NOOB#Flashing_to_eMMC_using_Rockchip_Tools_.28Rock64_Only.29 Guide to flashing eMMC using Rockchip Tools]
The image boots from microSD card and from eMMC. To learn more about OpenBSD, please visit [https://www.openbsd.org/ OpenBSD main page]
* Please allow 3-5 minutes boot up time on first time for initialization
 
** [http://files.pine64.org/os/PinebookPro/Android/PinebookPro_20190807_stock_android_7.1_emmcboot.img.gz Direct download from pine64.org]
'''Download location'''
** MD5 (GZip file): DC4C330787E57FC05F9D7D740F741620
 
** File Size: 555MB
ARM64 images, (including support for Pinebook Pro), can be found here [https://www.openbsd.org/arm64.html OpenBSD arm64]


= Linux Installer Releases =
= Linux Installer Releases =
== Debian Installer ==
[[File:debian.png|right|100px]]


=== Daniel Thompson's Debian Installer for the Pinebook Pro ===
== Manjaro ARM ==
* This is an image creator and Debian installer that runs from an existing Linux OS and installs Debian Bullseye
[[File:Manjaro.png|right|100px]]
** Installer can configure an encrypted rootfs and provides a choice of desktops, including the default Debian desktop based on Gnome 3
 
** Strict adoption of upstream Debian packages (with exception of kernel and bootloaders) in order to provide a clean upgrade path as Bullseye matures
The [https://gitlab.manjaro.org/manjaro-arm/applications/manjaro-arm-installer manjaro-arm-installer] script is intended to install Manjaro ARM directly to SD/eMMC cards without the need for images (including LXQT, Mate & CuboCore editions, as well as full disk encryption). Running on a Linux x86 computer, it can install Manjaro ARM directly to an empty eMMC using an eMMC to USB adapter. The script can also be run from SD to install an image to the eMMC.
* Download at: https://github.com/daniel-thompson/pinebook-pro-debian-installer/
* Pull requests welcome but for discussion and support please use [https://forum.pine64.org/showthread.php?tid=8487 the forum topic].


For more information, see the [[Pinebook_Pro_Debian_Installer]] wiki page
== Debian ==
[[File:debian.png|right|100px]]


=== Official Debian Installer Images ===
* Uses only the upstream kernel and firmware without special patches
* Uses only the upstream kernel and firmware without special patches
* No graphical display yet, works only through serial console
* Display doesn't always work properly on first boot of installer, usually fixed after a couple tries
* Requires adding the non-free component to your /etc/apt/sources.list file and installing the "firmware-linux" package for Wi-Fi and Bluetooth support
* Requires adding the non-free component to your /etc/apt/sources.list file and installing the "firmware-linux" package for Wi-Fi and Bluetooth support
* Installer is loaded into RAM, can install onto the same media from which it’s booted
* Installer is loaded into RAM, can install onto the same media from which it’s booted
* Supports automatic partitioning and full disk encryption through LVM
* Supports automatic partitioning and full disk encryption through LVM
* Installer currently doesn't install the bootloader, leaving the installed system in an unbootable state until it's manually added
* Installer currently doesn't install a functional bootloader, leaving the installed system in an unbootable state until it's manually added (if installed to eMMC, the system cannot be booted even to an SD card unless the eMMC is physically switched off or there is U-Boot in the SPI)


[https://d-i.debian.org/daily-images/arm64/daily/netboot/SD-card-images/ The relevant files are built daily here] and may sometimes be unavailable if the build system is having issues. The "README.concatenateable_images" file provides instructions on how to combine the partition.img.gz file with the firmware.pinebook-pro.rk3399.img.gz file in order to create a DD-able image.
[https://d-i.debian.org/daily-images/arm64/daily/netboot/SD-card-images/ The relevant files are built daily here] and may sometimes be unavailable if the build system is having issues. The "README.concatenateable_images" file provides instructions on how to combine the partition.img.gz file with the firmware.pinebook-pro.rk3399.img.gz file in order to create a DD-able image.


The official images are '''not''' recommended yet until the display begins working and the installer properly installs the bootloader. Most users will want to see [[Pinebook Pro Debian Installer|Daniel Thompson's Debian Installer]] instead.
The official images are '''not''' recommended yet until the display begins working consistently and the installer properly installs the bootloader. Most users will want to see [[Pinebook Pro Debian Installer|Daniel Thompson's Debian Installer]] instead.


== Gentoo Script ==
== Gentoo ==
[[File:GentooLogo.png|right|100px]]
[[File:GentooLogo.png|right|100px]]


=== Gentoo Script for Pinebook Pro ===
There is a script that prepares a Gentoo arm64 stage 3 tarball for the Pinebook Pro. Unfortunately, this script is not currently functional, and requires extensive troubleshooting to make work. New instructions are currently being created and will be available here.
* This is a script that prepares a Gentoo arm64 stage 3 tarball for the Pinebook Pro
** The script takes care of device specifics like an optimized make.conf, an overlay that provides kernel and firmware amongst others, and other miscellaneous fixes
* The usual tarball setup as per [https://wiki.gentoo.org/wiki/Handbook:AMD64 Gentoo Handbook] is left to the user.
* Forum thread with instructions at https://forum.pine64.org/showthread.php?tid=8765


==Kali Script==
 
'''Word to the wise'''
 
Currently, following the instructions on the Pinebook pro gentoo github page will *not* result in a functional system. Therefore it is neccesary to follow the instructions given here. Please bear in mind that the Pinebook pro's six arm cores and 4gb of ram are extremely anemic. For example, emerging the package net-libs/webkit-gtk in order to build the minimalist web-browser "surf", a process which takes eighty minutes on an intel core i5-8250U with 8gb of ram, required eight hours of compile time,
Basic installation alone can take 24 hours of compillation, dozens of reboots, and hours of troubleshooting. After that, even installing firefox would take 17 hours.
Now that that's out of the way, we may begin the installation.
 
'''Preparing the bootloader'''
 
Installing a functional bootloader can be difficult. Luckily, the tow-boot project provides a UEFI-like experience for some arm-based devices. Furthermore, it is not neccesary install this bootloader manually, as it will continue to be useable even after the disk has been reformatted, as long as the bootloader remains unscathed.
 
https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-minimal/
 
No-matter where you intend to install gentoo, the bootloader should always be installed on the eMMC flash, although technically the SD card slot could also be used. Either way, install any of the official Manjaro arm disk images to the internal eMMC (there's no reason not to use the minimal image, as you will not be using this OS for anything). You may use a second operating system installed on an SD-card, or the official Pine64 eMMC USB adapter. Boot into this operating system to ensure that the bootloader functions, but after that you have no further need of it.
 
Next, if you already have an OS on an SD card, you can use that for installing gentoo. If you don't, you may be pleasantly suprised to find that tow-boot is cabable of booting from a USB drive. Therefore, you may install the same Manjaro image to your USB drive or SD card, and select it from the boot menu. You should now have an unused but bootable OS on the eMMC, and another bootable, usable OS on your external storage.
 
'''Preparing the Disks'''
 
Log into your host device as root with the following command:
 
<code> sudo su </code>
 
Enter your password.
 
Let the device on which you intend to install gentoo be refered to hereafter as /dev/<gentoo>. Use the following command to prepare this disk for installation:
 
<code> fdisk -B /dev/<gentoo> </code>
 
Note: don't just copy these commands! You should substitute <gentoo> for mmcblk2 for the internal eMMC flash storage.
 
Note that the first block of the boot partition is block 62500. Delete all partitions, but *do not* re-format the disk. Create a new boot partition starting at 62500, and as it's size select "+1GB". Create a new swap partition. fdisk will try to start it at the beginning of the volume (before the boot partition) Instead, when it prompts you for the starting position, enter in the end sector of the boot partition. It should then tell you that this is within an existing partition, and recommend a slightly higher value. Press enter, and give for the size of the partition any value greater than "+4gb". You need this much ram to be able to suspend your system, and emerge large packages. Don't be stingey - you still have SD cards. I reccomend "+8gb".
Finally, add a root partition starting at the end sector of the swap partition, and use the rest of the disk for it. That should be 50-60 GB depending on the size of your swap and boot partitions.
 
Lastly, press "t" to set the type of each partition. You may set partition 1 to type 6, 2 to type 82, and 3 to type 83.
 
to set the partition types of the three partitions.
 
<code>lsblk</code>
 
to remind yourself which disk is /dev/<gentoo>
Write the filesystems to these three partitions with the commands:
 
<code>mkfs.vfat /dev/<gentoo>p1
 
mkswap /dev/<gentoo>p2
 
mkfs.ext4 /dev/<gentoo>p3</code>
 
 
This may be a slightly different format if you're installing to a usb stick.
 
'''Installation'''
 
make the directory for mounting the filesystem you just created. These should be made on the external OS.
 
<code>mkdir /mnt/gentoo
 
mount /dev/<gentoo>p3 /mnt/gentoo</code>
 
cd into this directory and fire up links. Navigate to gentoo.org/downloads and select the stage 3 minimal stage 3 tarball. Download it to your current directory, or move it to that directory from wherever it has been downloaded to. Once you are in the correct directory, unpack the tarball.
 
<code>tar xpvf stage3-arm64-<blah blah blah></code>
 
Mount the boot partition.
 
<code>mount /dev/<gentoo>p1 /mnt/gentoo/boot</code>
 
 
Chroot into the mounted directory and Install the operating system as per the AMD64 manual [https://wiki.gentoo.org/wiki/Handbook:AMD64]. Before you emerge anything, however, be sure to set your use flags as follows:
 
<code>nano /etc/portage/make.conf</code>
 
 
<code>MAKEOPTS="-j4 -l4"
 
ACCEPT_KEYWORDS="* **"
 
ACCEPT_LICENSE="*"
 
USE="X gtk bluetooth pulseaudio"
</code>
 
You can use your own options instead of these if you know what you're doing. It's not super difficult.
 
Continue installing the operating system, but stop just before emerging the @world set. I don't know if this is necessary, but I haven't had the time to try without doing this. Clone Janikk2099's github repo. It doesn't matter where, and run the script. If it fails run it a couple more times.
 
<code>git clone https://github.com/Jannik2099/gentoo-pinebookpro
 
./gentoo-pinebookpro/prepare.sh</code>
 
Don't follow any of Janikk's other instructions. They appear to be out of date (no offense bro). Let me be clear: DO NOT INSTALL U-BOOT. I don't know what will happen, but it won't be an improvement over the existing boot-loader so don't worry about it.
 
Finish installing your system until you come to the kernel.
 
'''Custom Kernel'''
 
Use sys-kernel/gentoo-kernel-bin as your kernel. You will need to manually edit the kernel configuration. First, select it as your kernel.
 
<code>eselect kernel list</code>
 
This should list only one option. Otherwise, select the number matching <code>linux-5.<whatever is latest>-gentoo-dist</code>, and cd into the kernel source directory.
 
<code>eselect kernel set <number>
 
cd /usr/src/linux</code>
 
Begin the kernel configuration
 
<code>make menuconfig</code>
 
At this point, you're almost on your own. I don't know a strict cause-and-effect relationship between my kernel config and the behavior of my system. For starters, just go into platform selection and deselect everything except rockchip platforms. Once you're done save your configuration and exit. Make sure boot is mounted, and your fstab is set up with your swap mounted. Make sure dracut is installed.
 
<code>make
 
make modules
 
make dtbs
 
make install
 
make modules install
 
make dtbs_install
 
ls /lib/modules
 
dracut -f --kver <name of directory in /lib/modules matching your kernel, *not* the kernel name from eselect>
</code>
 
emerge the package extlinux and run <code>u-boot-update</code>. Open the extlinux configuration file.
 
<code>nano /boot/extlinux/extlinux.conf</code>
 
And configure it as follows:
 
LABEL <label of your choice, for example GENTOO ARM>
 
KERNEL /<name of your vmlinuz kernel image. Include the slash, but be relative to boot, not root.>
 
FDT /dtbs/<kernel-version>/rockchip/rk3399-pinebook-pro.dtb
APPEND initrd=/<name of initramfs image> root=PARTUUID-<nboot partition's PARTUUID, no quotes> rw rootwait
</code>
 
You can use the blkid command to find the PARTUUID of every partition on the machine. None of this configuration is guaranteed to work, but it worked for me, and given enough fiddling you can get it to work as well.
 
Now you should reboot the machine and see if it boots into gentoo. If it does: congratulations! If not, too bad. Try again.
 
== Kali Linux ==
[[File:Kali.jpeg|right|100px]]
[[File:Kali.jpeg|right|100px]]


=== Kali Linux for Pinebook Pro ===
There is a script to create official Kali Linux OS images for the Pinebook Pro. The script carries out the build process in entirety and is Pinebook Pro specific.
* This is a script to create official Kali Linux OS images for the Pinebook Pro
 
** The script carries out the build process in entirety and is Pinebook Pro specific
'''Installation'''
* Please pull the lastest [https://gitlab.com/kalilinux/build-scripts/kali-arm/blob/master/pinebook-pro.sh Kali Linux install script] from the project's GitLab.
 
* Please pull the latest [https://gitlab.com/kalilinux/build-scripts/kali-arm/blob/master/pinebook-pro.sh Kali Linux install script] from the project's GitLab.
* For more information regarding building the OS image please read the README instruction at https://gitlab.com/kalilinux/build-scripts/kali-arm/blob/master/README.md
* For more information regarding building the OS image please read the README instruction at https://gitlab.com/kalilinux/build-scripts/kali-arm/blob/master/README.md
== K1ss OS ==
[[File:K1ss.png|right|100px]]
There is a repository containing an unofficial port of KISS Linux to AARCH64. The tarball is built for generic aarch64, currently being tested on the Pinebook Pro. You can follow the ongoing discussion about K1ss Linux on the [https://forum.pine64.org/showthread.php?tid=9304 PINE64 forum].
'''Installation'''
* Please pull the latest [https://github.com/jedavies-dev/kiss-aarch64 K1ss Linux install script] from the project's GitHub.
== NixOS ==
[[File:nixos.png|right|100px]]
You can follow the ongoing discussion about NixOS on the [https://forum.pine64.org/showthread.php?tid=10524 PINE64 forum]. There is a good chance we will see Tier 1 support for aarch64, including the Pinebook Pro, in 2021 (see https://github.com/NixOS/rfcs/pull/87).
'''Installation'''
* This is instructions to install NixOS on the Pinebook Pro: https://nixos.wiki/wiki/NixOS_on_ARM/PINE64_Pinebook_Pro
* Please pull the latest [https://github.com/samueldr/wip-pinebook-pro samueldr's repository ] from the project's GitHub.
* [[NixOS Tutorials]]
== SkiffOS ==
[[File:SkiffOS-Icon-1.png|right|100px]]
'''Installation'''
* Instructions to build/install on the Pinebook Pro: https://github.com/skiffos/SkiffOS/tree/master/configs/pine64/book
* Please pull the latest version from the project's GitHub.
* Compiling the boot image takes approximately 30 minutes.
* Easily configure the kernel, compiler, etc with Buildroot.
* Pre-built ISOs will be available with the upcoming 2021.02 release.
== Slackware ==
<div style=float:right>[[File:slackware.jpg|right|100px]]</div>
[https://arm.slackware.com/ Slackware] is the world's oldest actively developed Linux distribution, providing a modern user land (applications) and Linux Kernel, within a more classic Unix Operating System environment.
More information can be found about Slackware in this [https://www.youtube.com/watch?v=A5PFYUttsWA&list=PL1XOSJnvang3IbwySOf6m3PK1gm13hS5s 20 minute video].
[https://docs.slackware.com/slackwarearm:inst Installation instructions].
[https://www.youtube.com/watch?v=QKs_RnFqLO8&list=PL1XOSJnvang3VLmqke2QbRitKtOD6Rm3t Installation guide video]


[[Category:PineBook Pro]]
[[Category:PineBook Pro]]

Revision as of 13:17, 20 April 2022

Linux OS Image Releases

For information on how to install these images onto your device, please see the NOOB Page, which includes information on writing images to the device eMMC or an SD card

Manjaro ARM

The Manjaro project offers a mainline kernel with patches and modules to support PBPro hardware. To learn more about Manjaro please visit Manjaro Forum. You can follow the ongoing discussion about Manjaro on the PINE64 forum. All images boot from both SD card and the internal eMMC module.

Manjaro ARM with KDE Plasma

Manjaro ARM with Xfce

Manjaro ARM with Gnome

Manjaro ARM with Sway

Manjaro ARM with no desktop

Armbian

Armbian.png

As of Nov. 3rd, 2021, Pinebook Pro has No official support (CSC) from Armbian.

To find out more about Armbian and available options please visit their site.

Armbian Ubuntu Focal with Xfce (mainline kernel)

Armbian provides a mainline kernel build images for Ubuntu Focal with Xfce Desktop. It boots from microSD card and from eMMC.

Download location

Get the latest image here: Armbian's Pinebook Pro Ubuntu Focal Xfce

Armbian Ubuntu Focal with Gnome (mainline kernel)

Armbian provides a mainline kernel build images for Ubuntu Focal with GNOME Desktop. It boots from microSD card and from eMMC.

Download location

Get the latest image here: [1]

Armbian Ubuntu Focal with Xfce (legacy kernel)

Armbian provides a legacy kernel 4.4 build images for Ubuntu Focal with Xfce Desktop. It boots from microSD card and from eMMC.

Download location

Get the latest image here: Armbian's Pinebook Pro Ubuntu Focal Xfce

Armbian Debian Buster with Xfce (legacy kernel)

Armbian provides a legacy kernel 4.4 build images for Debian Buster with Xfce Desktop. It boots from microSD card and from eMMC.

Download location

Get the latest image here: Armbian's Pinebook Pro Debian Buster Xfce

Armbian Ubuntu Bionic with Xfce (legacy kernel)

Armbian provides a legacy kernel 4.4 build images for Ubuntu Bionic with Xfce Desktop. It boots from microSD card and from eMMC.

Download location

Get the latest image here: Armbian's Pinebook Pro Ubuntu Bionic Xfce Desktop download site

Twister OS

Twister OS.png

Twister OS Armbian-Reforged with Xfce. It boots from microSD card and from eMMC. For more information on Twister OS, please visit this official site. You can follow the ongoing discussion about Twister OS on the PINE64 forum.

Installation

  • After flashing image, edit /boot/armbianEnv.txt, replace the dtb name with rk3399-pinebook-pro.dtb

Download location

Get the latest image here: Direct download latest images from Twister OS's website (size: 2.8GB)

Password

asdasd

Fedora

Fedora1.png

Fedora Official

Using this blog post it is now possible to run Official Fedora on the Pinebook Pro.

Notes Upstream Fedora uses SPI flash on the Pinebook Pro to manage uboot.

Fedora 32 with Cinnamon

This image contains an install of Fedora with Cinnamon desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the official website.

Download location

Get the latest image here: Fedora 32 Pinebook Pro Image

Username and password

root/fedora

Fedora 32 with KDE

This image contains an install of Fedora with KDE aka Plasma desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the official website.

Download location

Get the latest image here: Fedora 32 Pinebook Pro Image

Username and password

root/fedora

Fedora 32 with Xfce

This image contains an install of Fedora with Xfce desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the official website.

Download location

Get the latest image here: Fedora 32 Pinebook Pro Image

Username and password

root/fedora

Fedora 32 with Gnome

This image contains an install of Fedora with GNOME 3 desktop environment. It boots from microSD card and from eMMC. To learn more about Fedora please visit the official website.

Download location

Get the latest image here: Fedora 32 Pinebook Pro Image

Username and password

root/fedora

Arch Linux ARM

Archlinux-logo.png

Official Installation

See Installing Arch Linux ARM On The Pinebook Pro for instructions on how to install the official Arch Linux ARM.

Customized Premade Image

Arch Linux ARM root filesystem customized for the Pinebook Pro using Manjaro kernel. Instructions are included for installation on microSD card, eMMC module and NVME SSD.

Download location

Get the latest image from GitHub (size: 591 MB).

Installation

Make sure to thoroughly read the readme, installation instructions and FAQ.

Username and password

The default Arch Linux ARM user credentials.

Username: alarm

Password: alarm

The password for the root account is 'root'.

postmarketOS

PostmarketOS logo.png

Official postmarketOS build with the GNOME desktop for the Pinebook Pro. It boots from microSD card and from eMMC.

Download location

Get the latest image here: Direct download latest images from postmarketOS (size: 400 MB)

Username and password

demo/demo

or:

demo/147147

Kali Linux

Kali Linux prebuilt OS images for Pinebook Pro

Official pre-built OS images of Kali Linux for the Pinebook Pro featuring all tools you'd expect from the distribution. It boots from microSD card and from eMMC.

Download location

Get the latest image here: Direct download latest images from Offensive Security's website (size: 2.0 GB)

Username and password

kali/kali

Q4OS

Q4os.png

Q4OS is advertised as a 'fast and powerful operating system based on the latest technologies while offering highly productive desktop environment'. It boots from microSD card and from eMMC. To learn more please visit the PINE64 forum or official Q4OS website.

Download location

Get the latest image here: Direct download latest release build from SourceForge

Username and password

User account and password are created on first run.

DietPi

Dietpi.png

openSUSE

Opensuse-distribution.png

Download location

Get the latest openSUSE Tumbleweed images for Pinebook Pro here: [2]

Credits to [3] Step 1. Flash Tow-Boot[4] to SPI Step 2. Flash openSUSE image to sd card & insert it Step 3. When it loads grub, press e and add the following line:

devicetree /boot/dtb/rockchip/rk3399-pinebook-pro.dtb

Press ctrl + x to boot

Work : display, wifi Not tested : bluetooth Doesn't work : audio

You may build rpms and see if it fix issues from this repository: [5]

FydeOS

An operating system based on the Chromium Project

https://fydeos.io/download/device/pinebook-pro

BSD

NetBSD

Netbsd.png

The image boots from microSD card and from eMMC. To learn more about NetBSD please visit NetBSD main page

Download location

Get the latest image here: Direct download from NetBSD

Installation

Instructions concerning enabling SSH can be found here.

Username and password

root/(none)

OpenBSD

Puffy mascot openbsd.png

The image boots from microSD card and from eMMC. To learn more about OpenBSD, please visit OpenBSD main page

Download location

ARM64 images, (including support for Pinebook Pro), can be found here OpenBSD arm64

Linux Installer Releases

Manjaro ARM

The manjaro-arm-installer script is intended to install Manjaro ARM directly to SD/eMMC cards without the need for images (including LXQT, Mate & CuboCore editions, as well as full disk encryption). Running on a Linux x86 computer, it can install Manjaro ARM directly to an empty eMMC using an eMMC to USB adapter. The script can also be run from SD to install an image to the eMMC.

Debian

Debian.png
  • Uses only the upstream kernel and firmware without special patches
  • Display doesn't always work properly on first boot of installer, usually fixed after a couple tries
  • Requires adding the non-free component to your /etc/apt/sources.list file and installing the "firmware-linux" package for Wi-Fi and Bluetooth support
  • Installer is loaded into RAM, can install onto the same media from which it’s booted
  • Supports automatic partitioning and full disk encryption through LVM
  • Installer currently doesn't install a functional bootloader, leaving the installed system in an unbootable state until it's manually added (if installed to eMMC, the system cannot be booted even to an SD card unless the eMMC is physically switched off or there is U-Boot in the SPI)

The relevant files are built daily here and may sometimes be unavailable if the build system is having issues. The "README.concatenateable_images" file provides instructions on how to combine the partition.img.gz file with the firmware.pinebook-pro.rk3399.img.gz file in order to create a DD-able image.

The official images are not recommended yet until the display begins working consistently and the installer properly installs the bootloader. Most users will want to see Daniel Thompson's Debian Installer instead.

Gentoo

GentooLogo.png

There is a script that prepares a Gentoo arm64 stage 3 tarball for the Pinebook Pro. Unfortunately, this script is not currently functional, and requires extensive troubleshooting to make work. New instructions are currently being created and will be available here.


Word to the wise

Currently, following the instructions on the Pinebook pro gentoo github page will *not* result in a functional system. Therefore it is neccesary to follow the instructions given here. Please bear in mind that the Pinebook pro's six arm cores and 4gb of ram are extremely anemic. For example, emerging the package net-libs/webkit-gtk in order to build the minimalist web-browser "surf", a process which takes eighty minutes on an intel core i5-8250U with 8gb of ram, required eight hours of compile time, Basic installation alone can take 24 hours of compillation, dozens of reboots, and hours of troubleshooting. After that, even installing firefox would take 17 hours. Now that that's out of the way, we may begin the installation.

Preparing the bootloader

Installing a functional bootloader can be difficult. Luckily, the tow-boot project provides a UEFI-like experience for some arm-based devices. Furthermore, it is not neccesary install this bootloader manually, as it will continue to be useable even after the disk has been reformatted, as long as the bootloader remains unscathed.

https://manjaro.org/downloads/arm/pinebook-pro/arm8-pinebook-pro-minimal/

No-matter where you intend to install gentoo, the bootloader should always be installed on the eMMC flash, although technically the SD card slot could also be used. Either way, install any of the official Manjaro arm disk images to the internal eMMC (there's no reason not to use the minimal image, as you will not be using this OS for anything). You may use a second operating system installed on an SD-card, or the official Pine64 eMMC USB adapter. Boot into this operating system to ensure that the bootloader functions, but after that you have no further need of it.

Next, if you already have an OS on an SD card, you can use that for installing gentoo. If you don't, you may be pleasantly suprised to find that tow-boot is cabable of booting from a USB drive. Therefore, you may install the same Manjaro image to your USB drive or SD card, and select it from the boot menu. You should now have an unused but bootable OS on the eMMC, and another bootable, usable OS on your external storage.

Preparing the Disks

Log into your host device as root with the following command:

sudo su

Enter your password.

Let the device on which you intend to install gentoo be refered to hereafter as /dev/<gentoo>. Use the following command to prepare this disk for installation:

fdisk -B /dev/<gentoo>

Note: don't just copy these commands! You should substitute <gentoo> for mmcblk2 for the internal eMMC flash storage.

Note that the first block of the boot partition is block 62500. Delete all partitions, but *do not* re-format the disk. Create a new boot partition starting at 62500, and as it's size select "+1GB". Create a new swap partition. fdisk will try to start it at the beginning of the volume (before the boot partition) Instead, when it prompts you for the starting position, enter in the end sector of the boot partition. It should then tell you that this is within an existing partition, and recommend a slightly higher value. Press enter, and give for the size of the partition any value greater than "+4gb". You need this much ram to be able to suspend your system, and emerge large packages. Don't be stingey - you still have SD cards. I reccomend "+8gb". Finally, add a root partition starting at the end sector of the swap partition, and use the rest of the disk for it. That should be 50-60 GB depending on the size of your swap and boot partitions.

Lastly, press "t" to set the type of each partition. You may set partition 1 to type 6, 2 to type 82, and 3 to type 83.

to set the partition types of the three partitions.

lsblk

to remind yourself which disk is /dev/<gentoo> Write the filesystems to these three partitions with the commands:

mkfs.vfat /dev/<gentoo>p1

mkswap /dev/<gentoo>p2

mkfs.ext4 /dev/<gentoo>p3


This may be a slightly different format if you're installing to a usb stick.

Installation

make the directory for mounting the filesystem you just created. These should be made on the external OS.

mkdir /mnt/gentoo

mount /dev/<gentoo>p3 /mnt/gentoo

cd into this directory and fire up links. Navigate to gentoo.org/downloads and select the stage 3 minimal stage 3 tarball. Download it to your current directory, or move it to that directory from wherever it has been downloaded to. Once you are in the correct directory, unpack the tarball.

tar xpvf stage3-arm64-<blah blah blah>

Mount the boot partition.

mount /dev/<gentoo>p1 /mnt/gentoo/boot


Chroot into the mounted directory and Install the operating system as per the AMD64 manual [6]. Before you emerge anything, however, be sure to set your use flags as follows:

nano /etc/portage/make.conf


MAKEOPTS="-j4 -l4"

ACCEPT_KEYWORDS="* **"

ACCEPT_LICENSE="*"

USE="X gtk bluetooth pulseaudio"

You can use your own options instead of these if you know what you're doing. It's not super difficult.

Continue installing the operating system, but stop just before emerging the @world set. I don't know if this is necessary, but I haven't had the time to try without doing this. Clone Janikk2099's github repo. It doesn't matter where, and run the script. If it fails run it a couple more times.

git clone https://github.com/Jannik2099/gentoo-pinebookpro

./gentoo-pinebookpro/prepare.sh

Don't follow any of Janikk's other instructions. They appear to be out of date (no offense bro). Let me be clear: DO NOT INSTALL U-BOOT. I don't know what will happen, but it won't be an improvement over the existing boot-loader so don't worry about it.

Finish installing your system until you come to the kernel.

Custom Kernel

Use sys-kernel/gentoo-kernel-bin as your kernel. You will need to manually edit the kernel configuration. First, select it as your kernel.

eselect kernel list

This should list only one option. Otherwise, select the number matching linux-5.<whatever is latest>-gentoo-dist, and cd into the kernel source directory.

eselect kernel set <number>

cd /usr/src/linux

Begin the kernel configuration

make menuconfig

At this point, you're almost on your own. I don't know a strict cause-and-effect relationship between my kernel config and the behavior of my system. For starters, just go into platform selection and deselect everything except rockchip platforms. Once you're done save your configuration and exit. Make sure boot is mounted, and your fstab is set up with your swap mounted. Make sure dracut is installed.

make

make modules

make dtbs

make install

make modules install

make dtbs_install

ls /lib/modules

dracut -f --kver <name of directory in /lib/modules matching your kernel, *not* the kernel name from eselect>

emerge the package extlinux and run u-boot-update. Open the extlinux configuration file.

nano /boot/extlinux/extlinux.conf

And configure it as follows:

LABEL <label of your choice, for example GENTOO ARM>

KERNEL /<name of your vmlinuz kernel image. Include the slash, but be relative to boot, not root.>

FDT /dtbs/<kernel-version>/rockchip/rk3399-pinebook-pro.dtb

APPEND initrd=/<name of initramfs image> root=PARTUUID-<nboot partition's PARTUUID, no quotes> rw rootwait

You can use the blkid command to find the PARTUUID of every partition on the machine. None of this configuration is guaranteed to work, but it worked for me, and given enough fiddling you can get it to work as well.

Now you should reboot the machine and see if it boots into gentoo. If it does: congratulations! If not, too bad. Try again.

Kali Linux

There is a script to create official Kali Linux OS images for the Pinebook Pro. The script carries out the build process in entirety and is Pinebook Pro specific.

Installation

K1ss OS

There is a repository containing an unofficial port of KISS Linux to AARCH64. The tarball is built for generic aarch64, currently being tested on the Pinebook Pro. You can follow the ongoing discussion about K1ss Linux on the PINE64 forum.

Installation

NixOS

You can follow the ongoing discussion about NixOS on the PINE64 forum. There is a good chance we will see Tier 1 support for aarch64, including the Pinebook Pro, in 2021 (see https://github.com/NixOS/rfcs/pull/87).

Installation

SkiffOS

SkiffOS-Icon-1.png

Installation

  • Instructions to build/install on the Pinebook Pro: https://github.com/skiffos/SkiffOS/tree/master/configs/pine64/book
  • Please pull the latest version from the project's GitHub.
  • Compiling the boot image takes approximately 30 minutes.
  • Easily configure the kernel, compiler, etc with Buildroot.
  • Pre-built ISOs will be available with the upcoming 2021.02 release.

Slackware

Slackware.jpg

Slackware is the world's oldest actively developed Linux distribution, providing a modern user land (applications) and Linux Kernel, within a more classic Unix Operating System environment.

More information can be found about Slackware in this 20 minute video.

Installation instructions.

Installation guide video