Before you set up an environment for webOS Open Source Edition (OSE) development, make sure that you prepare the target device and systems that meet the following requirements.
Note webOS OSE cannot be built directly on the target device. You must use a separate Linux machine that meets the Build System Requirements.
Target Device Requirements
A target device is a device that runs webOS OSE. To test apps and services on your target device, we recommend that you prepare the following set of hardware and peripheral devices.
For webOS OSE 2.0.0 or Higher
Raspberry Pi 4
microSD card (8 GB or larger) and microSD card reader device
HDMI-compatible touchscreen using USB interface, with 1920x1080 resolution
Micro HDMI to HDMI cable
Ethernet cable and internet connection
(Optional) Input devices such as a keyboard and a mouse
Note From the version 2.0.0, webOS OSE officially supports Raspberry Pi 4 Model B. We recommend using 4 GB or higher model to avoid insufficient memory issues.
Caution We do not support running webOS OSE 2.0.0 or higher on Raspberry Pi 3.
For webOS OSE 1.x
Raspberry Pi 3
microSD card (8 GB or larger) and microSD card reader device
A build system is a computer that builds an image from webOS OSE source code. To build a webOS OSE image, you need a Linux machine. Building under Windows or macOS is currently not supported.
Note If you cannot afford to build the image on your own, try with pre-built images.
Operating System
webOS OSE can be built on the 64-bit version of Ubuntu Long Term Support (LTS) releases, including:
Caution We strongly advise you NOT to use a Linux virtual machine on Windows or macOS for building webOS OSE, as it might cause unexpected issues.
Hardware
CPU
Recommended: Intel Core i7 quad-core with 8 threads or higher
RAM
Recommended: 16 GB or higher
Storage
Minimum: HDD with 300 GB of free disk space
Recommended: SSD with 300 GB of free disk space or more
Note See also our test results for the actual time build webOS OSE.
Git
Before you start building webOS OSE, you need to set up Git on your build system.
Host Machine Requirements
On the host machine, you can flash the built image to the target device or use SDK tools for further development processes. You can use Linux, Windows, or macOS for the host machine.
Note The build system (Linux machine) can be also used as a host machine for further development processes.
Operating System
Recommended version for each operating system are as follows:
Linux: Ubuntu 18.04 LTS or higher
Windows: Windows 7 or higher
macOS: Mac OS X 10.6 Snow Leopard or higher
Software Tools
Prepare the following tools on the host machine.
Git
To use SDK tools properly, set up Git on your host machine.
Tools for Enact-based App Development
To develop an app using Enact library, you need to install Node.js. For information on the suitable version, refer to Enact Installation page.