Everything you need to run SimplEOS

SimplEOS is a non-custodial desktop wallet for the EOS blockchain, built by EOS Rio as an Electron application. Private keys never leave your machine: they are encrypted locally with a password you choose and used only to sign transactions that are then broadcast to a public API endpoint.

The wallet exposes the full native feature set of EOSIO — token transfers, staking and unstaking, REX lending, CPU/NET/RAM management, Block Producer voting, proxy delegation, permission editing and contract action inspection — through a single interface, with no browser extension required.

Download the package for your platform from the Download section, then follow the steps for your operating system. Always verify the checksum published with the release before installing.

1. 01
   Windows

   Run the signed installer, accept the prompt and launch SimplEOS from the Start menu. Updates are delivered in-app.

2. 02
   macOS

   Open the .dmg and drag SimplEOS to Applications. On first launch use right-click → Open if Gatekeeper blocks the app.

3. 03
   Linux

   Make the AppImage executable with chmod +x SimplEOS.AppImage and run it, or install the .deb with sudo dpkg -i.

4. 04
   Verify

   Compare the SHA-256 hash of the downloaded file with the hash listed on the release page before running it.

# Linux
chmod +x SimplEOS-2.x.AppImage
./SimplEOS-2.x.AppImage

# verify the download
sha256sum SimplEOS-2.x.AppImage

On first launch SimplEOS creates an encrypted local vault. The password you set protects every key stored in the application and is required to unlock the wallet and to sign transactions.

1. 01
   1 — Set vault password

   Use a long, unique passphrase. It cannot be recovered or reset by anyone.

2. 02
   2 — Choose network

   Select the EOS mainnet endpoint, or add a custom endpoint for testnets.

3. 03
   3 — Import an account

   Import an existing EOS account with its private key, or connect a hardware wallet.

4. 04
   4 — Lock timeout

   Configure auto-lock so the vault seals itself after a period of inactivity.

EOS accounts are human-readable names controlled by keys. To manage an account in SimplEOS you import a private key that is authorised by one of the account permissions — typically active for daily operations and owner for recovery.

1. 01
   By private key

   Paste a WIF private key; SimplEOS derives the public key and discovers every account it controls.

2. 02
   By account name

   Enter the account name to fetch its permission tree, then supply the matching key.

3. 03
   Watch-only

   Add an account without keys to monitor balances, resources and voting without signing ability.

4. 04
   Multiple accounts

   Any number of accounts can live in one vault; switch between them from the account selector.

Keys are stored encrypted with AES using a key derived from your vault password. They are decrypted in memory only for the moment a transaction is signed and are never transmitted.

EOSIO permissions are a tree of named authorities, each with a threshold and a weighted list of keys or accounts. SimplEOS lets you inspect and edit this structure, including creating custom permissions linked to specific contract actions.

# example authority for a 2-of-3 active permission
threshold: 2
keys:
  - EOS7...abc  weight: 1
  - EOS8...def  weight: 1
accounts:
  - alice@active weight: 1

When a transaction does not reach the required threshold it is stored as a proposal via eosio.msig, where the remaining signers can approve it before execution.

Ledger devices are supported for signing. With a hardware wallet the private key never exists on the computer — SimplEOS builds the transaction, the device displays it, and only the signature returns to the application.

1. 01
   1

   Install the EOS app on the Ledger device via Ledger Live.

2. 02
   2

   Connect and unlock the device, then open the EOS app.

3. 03
   3

   In SimplEOS choose Import → Hardware wallet and select the derivation path.

4. 04
   4

   Confirm every transaction on the device screen before it is broadcast.

Transfers call the transfer action of a token contract. For EOS this is eosio.token; other tokens use their own contract, which SimplEOS resolves automatically for known assets and accepts manually for custom ones.

EOS transactions consume bandwidth resources instead of a per- transaction fee. SimplEOS shows live usage and lets you adjust each resource independently.

If a transaction fails with exceeded the current CPU usage limit, increase CPU by staking more EOS, renting resources, or waiting for the allowance to refill.

Staking locks EOS into CPU and NET bandwidth for your account. Unstaking returns the tokens to the liquid balance after the network refund period.

Staked EOS carries voting weight in Block Producer elections. You can vote for up to 30 producers directly, or delegate your weight to a proxy that votes on your behalf.

1. 01
   Direct voting

   Select producers from the list; your full stake weight applies to each one you choose.

2. 02
   Proxy voting

   Pick a registered proxy account to inherit its votes automatically.

3. 03
   Vote decay

   Voting weight decays over time — re-vote periodically to keep it at full strength.

SimplEOS talks to the chain through standard EOSIO HTTP APIs. You can switch endpoints, add your own node, or point the wallet at a testnet without reinstalling.

# add a custom endpoint
Name:      My Node
Protocol:  https
Host:      api.example.com
Port:      443
Chain ID:  aca376f2...4d1a3 (EOS mainnet)

A wrong chain ID makes signatures invalid on the target network — verify it when configuring testnets.

1. 01
   Export keys

   Export each private key and store it offline — paper, metal backup or an encrypted volume.

2. 02
   Backup the vault

   Copy the encrypted vault file; it is useless without the vault password.

3. 03
   Test the restore

   Reinstall on a second machine and import from your backup to confirm it works.

4. 04
   Owner key hygiene

   Keep the owner key offline and use active for daily operations so a leak can be repaired.

SimplEOS is an Electron application. Building locally lets you verify the published binaries or run a development build.

git clone https://github.com/eosrio/simpleos.git
cd simpleos
npm install
npm run electron:serve     # development
npm run electron:build     # production package