Tutorial

Get Daana CLI running in 5 minutes and see results in 10 more.

This setup is similar to the Setup Guide, but includes sample data and pre-written mappings tailored for learning Daana.

What You'll Learn

Quick Setup (5 min)

Prerequisites

• Docker: Install Docker Desktop (opens in a new tab)
• Terminal: Any terminal works, but we recommend an IDE with integrated terminal

Step 1: Install Daana CLI

Download the binary for your platform and install:

# Extract and install
tar -xzf daana-cli_*_<OS>_<ARCH>.tar.gz
sudo mv daana-cli /usr/local/bin/
 
# Verify it works
daana-cli --version

Note: If you don't have the download link, contact your Daana representative.

Step 2: Create Your Tutorial Project

# Create project with the quickstart example
daana-cli init my-tutorial --example quickstart
cd my-tutorial

This creates a complete project with:

• model.yaml - Book Retailer data model (CUSTOMER, ORDER entities)
• workflow.yaml - Pre-configured workflow
• connections.yaml - Database connections
• docker-compose.yml - Local PostgreSQL databases
• mappings/ - Pre-written mappings (the key differentiator!)
• data/ - Sample SQL data files
• setup.sh - Automated data loading script

Step 3: Start Databases and Load Data

# Start PostgreSQL containers
docker-compose up -d
 
# Load the Book Retailer sample data
./setup.sh

You should see:

Database setup complete!

Verifying data...
   Loaded 12 customer records
   Loaded 275 address snapshots
   Loaded 10 orders

Step 4: Install Daana Framework

daana-cli install

This creates the internal tables Daana uses for orchestration.

You're Ready!

Everything is set up. Continue to Chapter 1: Jump Start to see the magic happen.

Sample Data Overview

The Book Retailer dataset includes:

• 12 customers with profile data
• 275 address snapshots (daily snapshots showing customer moves)
• 10 orders with line items

This small dataset demonstrates Daana's key features: multi-source merging and time-travel queries.

Troubleshooting

Docker not running?

• macOS: Check menu bar for Docker icon
• Windows: Check system tray for Docker icon
• Linux: Run sudo systemctl start docker

Need help?

• Check the Command Reference for detailed options
• Contact your Daana representative