Razer Phone 2



Phone 2



System Type







Mobile NixOS repository


Hydra (default build)


This will build the default output for your Razer Phone 2.

$ nix-build --argstr device razer-cheryl2 -A build.default


The device will need to be booted in its bootloader, or fastboot, mode. The boot image can be installed using the following command, assuming it was built using the previous command.

$ result/flash-critical.sh

If you have a system image (system.img) built, you can use fastboot to flash it to the device. Note that it might be too big to fit over the system partition. In such case, it can be flashed on the userdata partition.

This will erase everything on the partition. Additionally, the common backups methods, e.g. TWRP, will not backup the userdata partition.
$ fastboot flash userdata system.img

Device-specific notes

Display problems

The video drivers from the vendor do not support being used with the classic framebuffer.

Only DRM (Direct Rendering Manager) is supported.

A workaround, for the time being, is to use simplefb. Though when the device boots in the default system, the simplefb framebuffer stops working. It is suspected that it is the video drivers switching the display to HDR that are causing this issue.

A workaround to help with this workaround has been implemented. When booted in the default system, the early init will reboot to recovery. In recovery mode the kernel does not exhibit this issue.

The solution to this problem will be to properly support DRM-only workflows.

Another avenue for solving this is to fix the fbdev emulation driver for the Qualcomm vendor tree.

Yet another is to explore using mainline. Though it is unknown if the dual-DSI display, for which the vendor driver is unique, would work well with the generic code working with other SDM845 devices.

$ cd /sys/class/leds
$ for f in *channel*/brightness *channel*/led_current; do echo 25 > $f; done