Launch a TELA site (CLI)

Create Your Immutable Link Hub with TELA

This tutorial guides you through deploying an on-chain link hub using DERO's TELA framework. You'll clone an existing TELA smart contract (SCID), modify its HTML template to create your personalized link directory, and redeploy the updated version as a new TELA-DOC contract. Edits generate tamper-proof blockchain records, with TXIDs acting as cryptographic receipts of your site's history.

Prerequisites

1. TELA-CLI installed (from source (opens in a new tab))
2. DERO wallet Testnet or Mainnet
3. Basic text editor (VS Code recommended)

TELA-CLI Basic Commands

Here are some essential commands to get you started:

Step 1: Launch TELA-CLI

Navigate to tela-cli directory.

cd tela-cli

Launch with mainnet daemon and Gnomon.

./tela-cli --daemon=node.derofoundation.org:11012 --gnomon

Step 2: Wallet Connection

Connect your wallet.

» wallet 
Enter wallet file path » /path/to/your/wallet.db 

Step 3: Clone the Template

TELA's immutable update system creates new versions with each change. When cloning, you can specify the exact TXID to ensure you get the correct version. If there has been no changes to the page you can paste the SCID only. After you make updates to your page you must specify both the SCID and TXID to clone the exact version you want.

» clone
Enter SCID » e107f605bf1a3a1b27d264d010bc8ba263742012a5b246ae7fa782bd34613efb

Step 4: Modify Template Files

The cloned files will be saved to: /datashards/clone/DeroLinks/index.html.

Edit index.html with your preferred editor:

# For example replace Dero Project with your actual name
   <h1>Chakipu</h1>
   <h2>My Links</h2>
   <ul>
      <li><a href="https://nonsensus.io/people/chakipu/" target="_blank">Nonsensus Profile</a></li>

Optional

Create a dedicated directory for your files. Copy the index.html file from the datashards directory and paste it into your new directory.

Step 5: Install Modified Document

# From TELA-CLI root directory
» install-doc 
Confirm password »
Enter DOC file path » /path/to/your/index.html

# Follow prompts carefully:
1. Enter DOC description » <insert desired description>
2. Enter DOC icon » <http://example.com/icon.png or leave blank>
3. Enter DOC dURL » <insert desired dURL>
4. Enter DOC subDir » <press enter>
5. Compress file data (y/n) » y
6. Enter DOC install ringsize » 2
7. Confirm DOC install (y/n) » y
# Note the generated SCID

Step 6: Create Index Contract

» install-index
Confirm password »
Enter INDEX name » <insert desired name>
Enter INDEX description » <insert desired description>
Enter INDEX icon » <http://example.com/icon.png or leave blank>
Enter INDEX dURL » <insert desired dURL>
How many total documents are embedded in this INDEX? » 1
Enter DOC1 SCID » <paste SCID generated in previous step>
# Note the generated NEW_SCID

Step 7: Serve Your DeroLinks Site

Server will start on localhost:8082 by default.

» serve NEW_SCID  # Use SCID from install-index generated in previous step

Final Result