English | 简体中文

ohos-node

This project build Node.js for the OpenHarmony platform and releases pre-built packages.

Get Pre-built Packages

Pre-built packages are available from two sources:

1. GitHub Releases

2. Dist source — a self-hosted Node.js dist source compatible with nodejs.org/dist.

Usage

1. Manual install

Extract the tarball and add the bin directory to PATH:

tar -zxf node-v26.7.0-openharmony-arm64.tar.gz
export PATH=$PATH:$(realpath node-v26.7.0-openharmony-arm64/bin)

# You can now use the 'node' command.

2. Install via nvm / fnm

Install nvm / fnm via Harmonybrew, then configure them to use this dist source:

# nvm
NVM_NODEJS_ORG_MIRROR=https://ohos-node.com/dist nvm install v26.7.0
# fnm
FNM_NODE_DIST_MIRROR=https://ohos-node.com/dist fnm install 26

Build from Source

1. Manual Build

You need a Linux x64 host to cross-compile Node.js with the supplied build.sh.

Example on Ubuntu 24.04 x64:

sudo apt-get update && sudo apt-get install -y build-essential unzip jq
./build.sh v26.7.0

Ubuntu 26.04 is not supported.

2. CI Build

If you are familiar with GitHub Actions, reuse the workflow file in this repo to build on GitHub’s runners, and no local environment required.

Steps for your own builds:

1. Fork this repo.
2. Enable workflow under the “Actions” tab.
3. Push commits or create a release to trigger the workflow.