Installation

Hologram is available for macOS, Linux, and Windows.

System Requirements

OS: macOS 10.15+, Windows 10+, or Linux (glibc 2.17+)
RAM: 4GB minimum, 8GB recommended
Storage: 500MB for application, additional space for blockchain data
Network: Internet connection for blockchain sync

Download

Download the latest release from the GitHub Releases (opens in a new tab) page.

Platform	Architecture	File
macOS	Universal (Intel + Apple Silicon)	`Hologram-v*-macos-universal.zip`
Linux	x64	`Hologram-v*-linux-amd64.tar.gz`
Windows	x64	`Hologram-v*-windows-amd64.zip`

Each archive ships with a matching .sha256 checksum file if you'd like to verify the download.

Installation Steps

macOS

Download the archive

Download Hologram-v*-macos-universal.zip from the Releases page. The universal binary runs natively on both Intel and Apple Silicon.

Unzip

Double-click the downloaded .zip to extract Hologram.app.

Move to Applications

Drag Hologram.app to your /Applications folder.

First Launch

Right-click Hologram.app and select Open for the first launch (required for unsigned apps).

⚠️

On macOS, you may need to allow the app in System Settings > Privacy & Security if you see a security warning on first launch.

Linux

Download the archive

Download Hologram-v*-linux-amd64.tar.gz from the Releases page.

Extract

tar -xzf Hologram-v*-linux-amd64.tar.gz

Run

./Hologram

Linux builds currently target glibc 2.35+ (Ubuntu 22.04 build host). If your distribution ships an older glibc, use Build from Source below.

Windows

Download the archive

Download Hologram-v*-windows-amd64.zip from the Releases page.

Extract

Right-click the .zip and choose Extract All…, or use your preferred archive tool.

Run

Double-click Hologram.exe to launch.

⚠️

Windows SmartScreen may show an "unrecognized app" warning on first launch. Click More info → Run anyway — the release is unsigned for v1.0.x.

First Run Wizard

On first launch, Hologram runs a First Run Wizard that auto-detects your environment before presenting options.

Automatic Detection

The wizard automatically checks for:

Running nodes — Scans for an existing derod process on default ports
Installed daemon — Checks if derod binary is already on your system
Blockchain data — Looks for existing blockchain databases at known locations

If a running node is found, the wizard offers to connect to it immediately.

Setup Options

After detection, you're presented with the appropriate choices:

Option	When Shown	What It Does
Start Embedded Node	`derod` found on system	Launches your local daemon with optional blockchain location selection
Connect to External Node	Always	Enter a remote node address (e.g., `http://192.168.1.1:10102`) and test the connection
Skip to Simulator	Always	Starts a local simulator environment for development — no real DERO needed

External Node Connection

When connecting to a LAN or remote node:

Enter the node endpoint (e.g., http://192.168.1.1:10102)
Click Test & Connect — Hologram verifies the node is reachable and returns chain info
On success, the endpoint is saved and Hologram connects automatically on future launches

Developer Support (EPOCH)

After node setup, the wizard shows a brief introduction to Developer Support (EPOCH):

Explains how passive hashing supports TELA app developers
Option to enable or skip Developer Support
Can be changed later in Settings > Developer Support

After Setup

Once the wizard completes, Hologram saves your preferences and proceeds to the main application. You can then:

Create or import a wallet
Browse TELA apps (read-only, no wallet needed)
Start developing with the local dev server

The wizard only runs once. To reconfigure your node connection later, go to Settings > Node.

Building from Source

For developers who want to build from source:

# Clone the repository
git clone https://github.com/DHEBP/HOLOGRAM.git
cd HOLOGRAM
 
# Install frontend dependencies
cd frontend && npm install && cd ..
 
# Download Go dependencies
go mod download
 
# Build for development
wails dev
 
# Build for production
wails build

Build All (Including Dependencies)

To build Hologram along with derod and simulator binaries from DERO source:

# Build everything from source
make all

This builds:

Hologram - The main application
derod - DERO daemon (from derohe source)
simulator - DERO simulator (from derohe source)

All binaries are placed in build/bin/ alongside the Hologram executable.

Building from source eliminates the need to download pre-built binaries and ensures you have matching versions of all components.

Build Requirements

Go 1.24.0+
Node.js 18+
Wails CLI v2 (go install github.com/wailsapp/wails/v2/cmd/wails@latest)
Platform-specific requirements (see Wails documentation)

Linux Dependencies

On Linux, you need GTK and WebKit development libraries:

# Ubuntu/Debian
sudo apt install libgtk-3-dev libglib2.0-dev libwebkit2gtk-4.0-dev
 
# Arch Linux
sudo pacman -S gtk3 glib2 webkit2gtk

Next Steps

Quick Start - Configure Hologram and browse your first dApp
Wallet Setup - Create or import a DERO wallet
Developer Support - Support TELA developers through EPOCH

Overview Quick Start