Runtime Getting Started
ElastOS Runtime is in active development. See the Roadmap for the current version and verified platforms.
Install
Download and install the signed elastos binary:
curl -fsSL https://elastos.elacitylabs.com/install.sh | bash
Capsules and providers are downloaded on demand, not bundled with the initial install.
Setup
Initialize your local environment:
elastos setup
This creates your local PC2 state directories, generates initial configuration, and prepares the runtime for use.
Optional Components
You can install additional components during or after setup:
elastos setup --with kubo --with ipfs-provider --with md-viewer
| Component | Purpose |
|---|---|
kubo | IPFS node for content-addressed storage and sharing |
ipfs-provider | Provider capsule that bridges IPFS into the runtime's namespace |
md-viewer | Markdown viewer capsule for rendering .md files |
Build From Source
Requires Rust 1.89+.
cargo install just
just build
just test
Or manually:
cd elastos && cargo build --workspace --release
Core Commands
Home
elastos
Opens your PC2 home surface -- your personal dashboard within the runtime.
Chat
elastos chat --nick alice
Peer-to-peer messaging through Carrier. Messages are exchanged directly, without a central server. Supports three execution modes: native, WASM, and microVM.
Share
elastos share README.md
Bundles the file, publishes to IPFS, and produces a content-addressed elastos://<cid> link. The content is signed and verifiable.
Open
elastos open elastos://<cid> --browser
Resolves, retrieves, verifies the signature, and renders in the appropriate viewer.
Site
elastos site stage ./website
elastos site serve --mode local
Host a personal site locally. Available in local mode (private) and ephemeral mode (temporary public link via cloudflared).
Update
elastos update
Pulls the latest signed release. Verifies Ed25519 signatures and SHA-256 checksums.
All Commands
elastos --help
See the Command Reference for the full command surface organized by runtime class.
Next Steps
- Capsule Model -- how the four capsule types work
- Capability System -- how permissions work
- Roadmap -- current status and what's coming