Skip to content
Greentic Docs

Installation

System Requirements

Section titled “System Requirements”

Minimum Requirements

Section titled “Minimum Requirements”
ComponentRequirement
OSLinux, macOS, Windows
Rust1.90+
Memory4 GB RAM
Disk2 GB free space
Section titled “Recommended”
ComponentRequirement
Rust1.91 (latest)
Memory8 GB RAM
CPUMulti-core processor

Installing Rust

Section titled “Installing Rust”

If you don’t have Rust installed:

Terminal window
curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh

Set the correct toolchain version:

Terminal window
rustup default 1.90

Add the WASM target for building components:

Terminal window
rustup target add wasm32-wasip2

Installing GTC CLI

Section titled “Installing GTC CLI”
Terminal window
cargo install greentic-cli

Verify Installation

Section titled “Verify Installation”
Terminal window
gtc --version

Expected output:

gtc 0.4.x

Optional Dependencies

Section titled “Optional Dependencies”

NATS (Message Bus)

Section titled “NATS (Message Bus)”

For production deployments:

Terminal window
docker run -d --name nats -p 4222:4222 nats:latest

Redis (Session Storage)

Section titled “Redis (Session Storage)”

For production session persistence:

Terminal window
docker run -d --name redis -p 6379:6379 redis:alpine

Ngrok/Cloudflared (Public URLs)

Section titled “Ngrok/Cloudflared (Public URLs)”

For webhook-based providers (Telegram, Slack, etc.):

Terminal window
# Install
brew install ngrok/ngrok/ngrok  # macOS
# or download from https://ngrok.com/download


# Configure
ngrok config add-authtoken YOUR_TOKEN


# Run
ngrok http 8080

Development Tools

Section titled “Development Tools”

Pack Builder

Section titled “Pack Builder”

Build .gtpack archives:

Terminal window
cargo install greentic-pack

Flow Validator

Section titled “Flow Validator”

Validate flow definitions:

Terminal window
cargo install greentic-flow

Component Authoring

Section titled “Component Authoring”

Create WASM components:

Terminal window
cargo install greentic-component

Verifying Your Setup

Section titled “Verifying Your Setup”

Run the following to verify everything is working:

Terminal window
# Check GTC CLI
gtc --help


# Check Rust WASM target
rustup target list --installed | grep wasm32-wasip2


# Create and run a test bundle
gtc wizard --dry-run

Troubleshooting

Section titled “Troubleshooting”

Common Issues

Section titled “Common Issues”

Error: “wasm32-wasip2 target not found”

Terminal window
rustup target add wasm32-wasip2

Error: “Cannot connect to NATS”

Terminal window
# Start embedded NATS with gtc start
gtc start ./my-bundle --nats on

Error: “Permission denied”

Terminal window
# On Linux/macOS, ensure binary is executable
chmod +x /usr/local/bin/gtc

Next Steps

Section titled “Next Steps”