---

  UBports Installer  

This tool is still under development, bugreports and contributions are appreciated!

---

  How to install  

  Linux  

Snap:

1. Open a terminal
2. Run snap install ubports-installer to install
3. Run ubports-installer or select the icon in your application list to start the program

Deb:

1. Download the latest deb file from https://github.com/ubports/ubports-installer/releases/latest
2. Open the deb package with your software installation tool and follow the on-screen instructions
3. Launch the program from your application list

Appimage:

1. Download the latest AppImage file from https://github.com/ubports/ubports-installer/releases/latest
2. Make the AppImage executable
3. Run the file by double-clicking

  Mac  

1. Download the latest dmg file from https://github.com/ubports/ubports-installer/releases/latest
2. Open the file and follow the onscreen instructions
3. Launch the program from the application list

  Windows  

1. Install the universal adb driver or a device-specific driver
2. Download the latest exe file from https://github.com/ubports/ubports-installer/releases/latest
3. Launch the program and follow the on-screen instructions

---

🔥   Usage   🔥

Using the graphical user interface of the UBports Installer is recommended for most cases.
Powerusers can also make use of the experimental command-line interface. See ubports-installer -h for information.

---

🔧   Troubleshooting   🔧

Troubleshooting information can be found in the docs. If you need help, you can join UBports' support channels on telegram or matrix or ask a question in the forum or on askubuntu. If you believe that the UBports Installer is not working correctly, you can also file a new issue to help us solve the problem. As a last resort, we also have manual installation instructions for every device, that you can follow if you want to install without using the UBports Installer.

---

📜   How to run the program from source   📜

git clone https://github.com/ubports/ubports-installer.git
cd ubports-installer
./setup-dev.sh

Run with npm

You will have to either install fastboot and adb or run a build once (see below) to download the fallback tools.

npm start            # for the normal mode with GUI
npm start -- -D      # for debug tools and verbose logging
npm start -- --cli   # for CLI mode without GUI

Build packages

npm run-script dist:linux
npm run-script dist:mac
npm run-script dist:win

---