Installing TERE

Updated May 17, 20255 min read

This guide walks you through installing and configuring the TERE SDK and CLI tools. TERE supports multiple platforms and can be integrated with various development environments.

Prerequisites

Before installing TERE, make sure you have the following:

  • Node.js 18.0.0 or later
  • npm 7.0.0 or later (or yarn/pnpm)
  • For local development: Docker Desktop 4.0.0 or later
  • For production: Access to a cloud provider with confidential computing support

For local development and testing, TERE provides a TEE simulator that doesn't require specialized hardware.

Installing the TERE SDK

The TERE SDK is available as an npm package. To install it in your project:

bash
1# Using npm
2npm install @praecise/tere
3
4# Using yarn
5yarn add @praecise/tere
6
7# Using pnpm
8pnpm add @praecise/tere

This will install the TERE SDK and its dependencies in your project.

Installing the TERE CLI

The TERE CLI allows you to interact with TERE from the command line. It's recommended to install it globally:

bash
1# Using npm
2npm install -g @tere/cli
3
4# Using yarn
5yarn global add @tere/cli
6
7# Using pnpm
8pnpm add -g @tere/cli

Verify the installation by running:

bash
1tere --version

You should see the version number of the installed CLI tool.

Setting Up Authentication

To use TERE, you'll need to authenticate with your API key. You can obtain an API key from the TERE dashboard.

Using the CLI

Log in using the CLI:

bash
1tere login --api-key your-api-key

Using the SDK

When using the SDK in your code, initialize the client with your API key:

typescript
1import { TereClient } from '@praecise/tere';
2
3// Initialize client
4const client = new TereClient({
5 endpoint: 'https://api.tere.praecise.com',
6 apiKey: 'your-api-key'
7});

Keep your API key secure and never commit it to version control. Consider using environment variables to store it.

Installing the Local Development Environment

For local development and testing, TERE provides a local development environment that simulates a Trusted Execution Environment:

bash
1# Install the local development environment
2tere dev install
3
4# Start the local development environment
5tere dev start
6
7# Verify it's running
8tere dev status

The local development environment runs in Docker and provides a simulated TEE for testing your applications without needing actual hardware-backed TEEs.

Cloud Provider Setup

For production deployments, TERE supports the following cloud providers with confidential computing capabilities:

Google Cloud Platform

  • Confidential VMs
  • Confidential GKE Nodes
  • AMD SEV & SEV-SNP support

View GCP Setup Guide

Troubleshooting

Common Installation Issues

IssueSolution
SDK installation fails with dependency errorsEnsure Node.js is updated to version 18 or later. Try clearing npm cache with npm cache clean --force before reinstalling.
CLI not found after global installationMake sure your PATH includes the global npm bin directory. You might need to restart your terminal or add the npm bin path to your environment variables.
Docker container fails to start for local developmentEnsure Docker Desktop is running. Check Docker logs for any errors. You might need to increase the allocated memory for Docker if you see out-of-memory errors.

If you encounter issues not covered here, please check our comprehensive troubleshooting guide.

Next Steps