Home / Playbooks / Theta edge node

Run a Theta Edge Node (Earn TFuel From Compute Jobs)

The one-command Docker node — pull the official image, set a password, and start earning TFuel for edge compute and encoding jobs.

Beginner⏱ ~30 minutes·Free (optional 10K+ TFuel for elite staking)·Updated 2026-11-03
Contents
  1. What you're getting into
  2. Install Docker & pull the image
  3. Run the edge node
  4. Verify the node & check rewards
  5. Optional: stake as an Elite Edge Node

1. What you're getting into

Theta's edge node earns TFuel for video encoding and edge compute jobs (Lavita, FedML). A basic node needs no GPU and no staking — but earnings are modest and job-dependent. The bigger yield path (Elite Edge Node) requires staking 10,000–500,000 TFuel.

RequirementBasic nodeElite node
RAM4GB4GB+
GPUOptional (CUDA jobs)Optional
StakeNone10,000+ TFuel
DockerRequiredRequired

2. Install Docker & pull the image

1. Install Docker on your always-on machine.

2. Pull the official edge node image:

docker pull thetalabsorg/edgelauncher_mainnet:latest

3. Run the edge node

Start the node with a password you choose (it protects your local keystore):

docker rm edgelauncher

docker run -e EDGELAUNCHER_CONFIG_PATH=/edgelauncher/data/mainnet \
  -e PASSWORD=YOUR_SECURE_PASSWORD \
  -v ~/.edgelauncher:/edgelauncher/data/mainnet \
  -p 127.0.0.1:15888:15888 -p 127.0.0.1:17888:17888 -p 127.0.0.1:17935:17935 \
  --name edgelauncher -it thetalabsorg/edgelauncher_mainnet:latest
Add --gpus all if you have Nvidia GPUs with drivers installed — this enables CUDA compute jobs. Use -d instead of -it to run detached.

4. Verify the node & check rewards

Query the local RPC to confirm the node is healthy:

# node status
curl -X POST -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"edgecore.GetStatus","params":[],"id":1}' \
  http://localhost:17888/rpc

# past jobs + rewards
curl -X POST -H 'Content-Type: application/json' \
  --data '{"jsonrpc":"2.0","method":"edgelauncher.GetPastJobs","params":[{"type":"lavita","page":0,"num":10}],"id":1}' \
  http://localhost:15888/rpc

5. Optional: stake as an Elite Edge Node

1. Get your Edge Node Holder summary via the local RPC (edgecore.GetEdgeNodeSummary).

2. In Theta Wallet, deposit 10,000+ TFuel to your edge node (max 500,000).

3. Staking rewards accrue back to the wallet you staked from.

4. Withdrawal has a ~60 hour unstaking period.

Your keystore lives at ~/.edgelauncher/edgecore/key/encrypted — protect it. Never share your password or keystore.

Tools used in this playbook

This guide contains referral links to some of the services mentioned. They cost you nothing and fund more testing. See disclosure.