How to Install TWRP and Lineage OS on the OnePlus One with Ubuntu

Most tutorials for installing recovery and Lineage OS (formerly known as Cyanogenmod) onto the OnePlus One are for Windows. This is how to do it on Ubuntu Linux. The version I’m using for this tutorial is Ubuntu Linux x86-64 17.04.

Installing the required tools on Ubuntu Linux (17.04)

Open a terminal window if using a desktop environment.

First, lets update our repositories to make sure we have the latest software versions available.

sudo apt-get update

Now we’ll install some tools from the Android SDK Platform that we’ll need to access the partitions on our phone.

sudo apt-get install android-tools-adb android-tools-fastboot

Lets check to see if abd is installed and running by executing its version printing function.

adb version

The output should read something such as:

Android Debug Bridge version 1.0.32

Next we’ll need to enable developer options and USB debugging on the OnePlus One. To do this, unplug your phone from USB and go to your Android settings. Scroll to the bottom and find the menu option “About phone” or “About devices”. Tap the build number 7 times. This should unlock the Developer options.

Go to to the main settings list and locate the entry “Developer options”. Tap that entry to enter. Then, locate the “Update Cyanogen recovery” entry and disable it. Next, locate the “USB debugging” entry and enable it.

Now, connect yout phone to USB and check to see if adb can see the device by running

adb devices -l

On the phone, you should be prompted to accept the connection from the computer. Allow this connection on your phone.

The command in adb should now show your device and its unique ID. If you can see this, you are ready for the next section.

Flashing the Bootloader / Recovery


Reboot your device into the bootloader mode with the command

adb reboot bootloader

Now, we will unlock the bootloader and erase the stock firmware.

sudo fastboot oem unlock

The phone will reboot, erase the stock bootloader, and start back up into android. Let it load through the boot process and startup, this may take awhile. In the mean time, you can download more required files.

Download TWRP

Download the latest TWRP image from

Download Lineage OS

Download the lastest version of Lineage OS for bacon:

Lineage OS Extras

Download any extras you may need from Lineage OS:

superuser binary (use wisely and with discretion) (for OnePlus One get the arm version):

OpenGapps (for Google services – YUCK!!):

Note: Personally, I’d recommend against using Gapps if you can avoid it. Once it is flashed onto the device it is extremely hard to remove without completely re-wiping your device. If you need a app/software repository, I’d recommend trying F-Droid (I will show you how to install it at the end of the tutorial) which has a much safer set of applications that typically are more respectful of your personal data and privacy. Google Apps are known to collect and sell massive amount of personal data and telemetry such as location / usage data, and contains many apps that will do the same. Many of the free apps will contain malicious advertisements as well.

In most cases, these files will now be saved in the Downloads folder of your user.

Once your device is done setting up Android again, you can skip through the introduction menus. Then go back into the settings menu and reenable the developer options in the menu, go into the developer options, disable “Update Cyanogen recovery” and enable “Android debugging”. Make sure the phone is still connected and when prompted by your phone, reallow access from your computer via the onscreen prompt.

To avoid confusion with other downloaded files, rename the twrp image file to “recovery.img”.

In terminal change directory into your Downloads folder or where you saved the other files to. We will now upload the new recovery software onto the phone after putting it back into recovery mode.


cd Downloads

adb reboot bootloader

sudo fastboot flash recovery recovery.img

fastboot will upload the TWRP image to the recovery partition. Allow it to finish. You know it has finished when it displays “finished. total time: ….”

Now, reboot the device.

sudo fastboot reboot

The phone will boot into android. Once it reaches Android, you can reboot into recovery by holding the power button + volume down buttons. Once the phone starts up, you can releasse the power button and only continue to hold down the volume down button on the device. This should bring you into TWRP.

Welcome to TWRP

Swipe to enable modifications. Do not keep your system partition in read-only. We will be writing to this partition.

Backup Cyanogen OS

First, lets make a backup of the stock Lineage OS that comes with the OnePlus One. I recommend you archive this somewhere on the device or on a hard drive just in case you ever need to restore the phone to stock.

Select the “Backup” menu entry. Select a name I prefer “$date – LineageOS Stock”. Select all the partitions to backup then swipe to start the backup process. It should take a minute then vibrate when its completed. Go back to the main menu.

Wipe the device

I’m not sure if this is necessary as flashing Lineage OS may overwrite the partitions but its safer to be sure and just wipe the partitions. The partitions we will wipe are: Dalvik, System, Data, and Cache. DO NOT wipe Internal Storage as that is what we have just used to store our backup. If you need to wipe the internal storage, make sure you copy the backup and other files over first. In my guide, I have my internal storage already cleaned up of any personal files.

Slide the slider to being the wipe process. It should complete quickly. Go back to the main menu.

Install Lineage OS

Once at the TWRP main menu, copy the main Lineage OS zip file to your internal storage on the device. Also, move any of the Lineage add-ons that you downloaded into this folder too. I have put my linage zip in my Downloads folder for now.

You can keep these in a folder on the device to have as a backup. You may come in handy in the future if you ever need to re-flash the system. so I’d recommend archiving them somewhere.

We will now install LineageOS and our add-ons. Select the “Install” entry in the main menu. Go to the “Downloads” folder. The main “lineage” .zip file that you downloaded and moved. Verify that you have selected the right file. Then swipe to confirm the flash. The phone will begin to unpack and flash the system partition with Lineage OS.

If you did not wipe the Dalivk / ART cache before in the wiping section of this guide, you should do this now.

If you want to apply the superuser / root function to your phone (only do this if you know what this does), you can do so now by going back to the main menu, selecting “Install” and doing the same process we just did except this time select the “addonsu” .zip file. You can follow this process to install “opengapps” as well.

You can now reboot the device from the menus. TWRP will offer to install a TWRP App. You do not need this. It is optional. I’ve unchecked both options and then pressed the “Do Not Install” button. TWRP will offer this almost every time you use the TWRP menu.

Your device will not reboot into Lineage OS. Congratulations you have completed the process! ­čÖé


If you encountered an error, its likely that the files that you downloaded were corrupt or did not download properly. Try downloading them again and retrying.

If you get stuck in a boot loop, try going back to TWRP and flashing an older version of Lineage OS.

Installing F-Droid

NOTE: You will need to have mobile data or a wifi connection to do this. Otherwise you will need to download the F-droid APK from your computer and transfer it via USB to your phone’s internal storage first.

To install the app repository, F-Droid, simply go through the intro Lineage OS menus on first boot. Once you reach the home-screen / desktop. You can open up your phone’s web browser and go to

Then select the Download F-Droid button on their site. Allow the browser to access storage, then select the download option. Your phone will download the APK file.

Once it is downloaded, select it from the phone’s drop down menu / notification slide down menu. You will be prompted that you need to enable unknown sources before you can install this. Click the settings option and you will be taken to your settings menu. Find the “Unknown sources” option and enable it. You will be prompted about the risk in doing this, press OK. Unknown sources should be enabled now.

Press the home key, open your app drawer, and select “Files”. Then select “Downloads”, then Select the FDriod.apk. Press “Install”. Your phone will install F-droid. When its done, press “done”.

Press the home button and open the app drawer again. Open the “settings” app and go to the “Security” section. Locate “Unknown source” and disable this option.

Now, go back to your app drawer and locate F-Droid. It will open. You need to press the refresh button in the top right (looks like a circle arrow) and F-Droid will update its repositories and show the apps you can install.


Thank you for reading! Hope this helped.


How to import a Windows Software RAID0 Partition in Ubuntu

I was struggling to find a way to import my Windows software RAID0 partition into Ubuntu. I tried several different methods and I’m surprised this wasn’t easier to discover. However, there is a simple solution for this.

All you need to do is download a tool called ldmtool and have it import your partition!

First, Download the tool.

sudo apt-get install ldmtool

Then, have ldmtool import your software RAID partition.

sudo ldmtool create all

Your RAID0 partition should automatically be imported and available to use in your filesystem! It will be mounted in your /media/$username  folder!


How to Upgrade Ubuntu 14.04.4 Server Edition to 16.04.1


This is just a short and sweet guide to showcase how easy it can be (bugs aside) to upgrade from Ubuntu 14.04.4 LTS to 16.04.1 LTS.

There is a simple command built into Ubuntu to upgrade to the next major release version easily. This command for the upgrade tool is:

sudo do-release-upgrade

This will start the upgrade tool. It will check to see if a new release upgrade version is available and then prompt you to upgrade.

16.04.1 just released this week and now this upgrade path is finally available for Ubuntu 14.04 LTS users.


How to enable SLI in Ubuntu 14.04 Trusty Tahr and 15.10 Wily Werewolf

Warning: this doesn’t work for most video cards and applications. SLI is extremely poorly implemented by NVidia in Linux. It does not work. I’d recommend getting a single card for a Linux system. Don’t bother unless you know what you’re doing.

I’ve been attempting to use Linux and Ubuntu a bit more. Its a bit of a learning experience for me, but its not too bad if you have some patience and can search for the right documentation. There has been a lot of concerns over Microsoft’s strong-handing users into Windows 10, privacy policies, and interface designs. Sounds like a good time to start committing to Linux a bit more.

Anyways, I game with some of my free time and I currently have two NVIDIA 760’s in a dual SLI configuration. It took me a minute to figure out how to enable SLI in Ubuntu 15.10. I figure I’ll write up a short document to help anyone else trying a similar process.

First, you’ll need to install NVIDIA proprietary drivers. You can usually get these from your operating system’s repository. Go into your system settings and select the the hardware or drivers subsection. This should allow you to search for a 3rd party NVIDIA driver to use. If for some reason this doesn’t work, you’ll need to get the drivers from NVIDIA’s website and install them manually. This is a longer and more involved process, so I won’t go into that.

Secondly, you’ll need to open up a terminal session and enter the following command with sudo.

sudo nvidia-xconfig --sli=on

If everything worked OK, you should get a confirmation like the one pictured below. At this point, you’re done. Enjoy SLI on your system!