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

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