Skip to content
greentic.ai Greentic Docs

Installation

System Requirements

Section titled “System Requirements”

Minimum Requirements

Section titled “Minimum Requirements”
ComponentRequirement
OSLinux, macOS, Windows
Rust1.95+
Memory4 GB RAM
Disk2 GB free space
Section titled “Recommended”
ComponentRequirement
Rust1.95+ (latest supported)
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.95

Add the WASM target for building components:

Terminal window
rustup target add wasm32-wasip2

Installing GTC CLI

Section titled “Installing GTC CLI”

Install the gtc router first, then let gtc install install the Greentic companion tools. Do not install greentic-cli or the individual companion crates directly for normal use; gtc install keeps the delegated binaries aligned with the router.

Terminal window
cargo install cargo-binstall
cargo binstall gtc
gtc install
gtc doctor

cargo binstall gtc installs the thin gtc router binary. gtc install then installs the Greentic companion tools that gtc delegates to, such as greentic-dev, greentic-setup, greentic-start, greentic-pack, and greentic-flow.

Verify Installation

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

Optional Dependencies

Section titled “Optional Dependencies”

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”

Greentic Toolchain

Section titled “Greentic Toolchain”

Install or update the delegated Greentic binaries used by the gtc router:

Terminal window
gtc install

Use gtc install --dry-run to preview the install plan. For controlled environments, pin the toolchain:

Terminal window
gtc install --release 1.0.15
gtc install --manifest ./greentic-toolchain.json

Component Authoring

Section titled “Component Authoring”

gtc install installs the standard companion tools. For standalone component development you may also install cargo-component:

Terminal window
cargo binstall cargo-component

Then use the delegated component surface:

Terminal window
gtc dev component --help

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: “Permission denied”

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

Next Steps

Section titled “Next Steps”