Install ElastOS

Before you start

Computer	Supported
Mac with Apple silicon (M1 or newer)	Yes. Browser included.
Linux, x86_64	Yes. No Browser App in 2.0.0.
Linux, ARM64 (for example a Jetson)	Yes. No Browser App in 2.0.0. See Jetson and headless Linux.
Mac with an Intel processor	No. The installer stops and says so.
Windows	Not yet. See Windows.

You also need:

a terminal, with curl and python3 (a Mac without Apple’s Command Line Tools gets them during install);
outgoing UDP on port 4433, for Carrier. Setup and updates use it;
free disk space. On a Mac, the Browser App downloads an image of about 900 MB. Setup shows the size and stops before the download if the disk is too small. Home still installs;
port 8090 free. If another program uses it, Home says so and does not start.

Install

Run the install command

Open a terminal and run:

curl -fsSL https://elastos.elacitylabs.com/install.sh | bash

Check the maintainer DID

The installer prints a line that starts with Maintainer DID:. Compare it with:

did:key:z6MkgwHd2BCWe1jHMXPiR6H1q1RFPcv1YzhMbK5G1kBarbfe

If they differ, stop and press Ctrl+C. This check proves that the release comes from the ElastOS maintainer.

Wait for Home to open

The installer checks the signed release, installs the Runtime, sets up Home and opens your browser at:

http://localhost:8090/home/

Keep the terminal open while you use Home. Ctrl+C in the terminal stops Home.

Create your account

Continue with First steps.

On a Mac without Apple’s Command Line Tools, the installer opens Apple’s installer for them. Click Install in Apple’s window. The ElastOS installer continues by itself when they are installed. It waits up to 20 minutes. If it stops, run xcode-select --install, wait for it to finish, then run the install command again.

What the installer checks

The signature on the release head, against the maintainer DID.
The signature on the release, against the same DID.
The SHA-256 hash of the Runtime binary.

Setup then checks every component in the same way. The web only carries bytes. Why this matters

What the installer changes

It installs the elastos command in ~/.local/bin.
It keeps the Runtime, your Apps and your data in one folder:
- Mac: ~/Library/Application Support/elastos
- Linux: ~/.local/share/elastos (or $XDG_DATA_HOME/elastos when set)
It adds one line to your login profile (~/.zprofile on a Mac, ~/.profile or ~/.bash_profile on Linux), so the elastos command works in new terminals. The line ends with # Added by the ElastOS installer, and the installer prints which file it changed. To skip this, set ELASTOS_NO_MODIFY_PATH=1 before you run the install command.
It adds no login items, launch agents or desktop entries.

Start Home again later

Home runs while its terminal is open. To start it again, for example after a restart, run:

elastos home --browser

Already have ElastOS?

From 0.7.1 or earlier: run the install command once. Releases now have a new signing key, and the installer trusts it. Your Home keeps its identity, accounts and files.
On a test channel: your Home updates to 2.0.0 in System and stays on the test channel. To move to Stable, run the install command.
Already on the current key: update in System. See Updates.

Install without opening Home

For automated setups, --install-only installs and stops before Home setup and launch:

curl -fsSL https://elastos.elacitylabs.com/install.sh | bash -s -- --install-only

Overview First steps