Getting Started with Teenode

Teenode is a confidential computing platform that lets you deploy applications and virtual machines with hardware-level security using AMD SEV-SNP technology. This guide will help you get up and running in minutes.

What is Teenode?

Teenode provides two main ways to run your workloads:

Git Deploy - Deploy Docker applications directly from your Git repositories with automatic builds and deployments
TEE VMs - Launch Trusted Execution Environment virtual machines on AMD SEV-SNP hardware for maximum security and isolation

Prerequisites

Node.js 20 or higher
npm, yarn, or pnpm
A Teenode account (create one at teenode.com)
Git (for Git Deploy projects)

Quick Setup (2 minutes)

The fastest way to get started is using the Teenode CLI. Follow these steps:

1. Install the CLI

npm install -g teenode-cli

2. Authenticate

teenode auth login

This will prompt you for your Teenode credentials and save your API key locally.

3. Verify Installation

teenode auth status

Your First Project

Let’s create and deploy your first project:

Step 1: Create a Project

teenode project create \
  --name my-first-app \
  --type TEE_VM \
  --region us-east

This creates a new TEE VM project in the US East region.

Step 2: Create a Virtual Machine

teenode vm create proj_abc123 \
  --cpu-cores 4 \
  --ram-mb 4096 \
  --disk-gb 100 \
  --os-image ubuntu-22.04

Replace proj_abc123 with your actual project ID from step 1.

Step 3: Wait for the VM to be Ready

# Check status
teenode vm info proj_abc123

# Wait until Status is ● RUNNING

Step 4: Connect via SSH

# Get connection info
teenode vm console proj_abc123

# SSH into your VM
ssh root@<public-ip>

Next Steps

Congratulations! You now have a Teenode VM running. Here’s what you can do next:

Deploy a Git App - Learn how to deploy a Docker application directly from GitHub
Verify Attestation - Cryptographically verify your VM’s security properties
CLI Reference - Explore all available CLI commands
Learn about AMD SEV-SNP - Understand the security technology powering Teenode

Common Commands

# Authentication
teenode auth login          # Login
teenode auth logout         # Logout
teenode auth status         # Check status

# Teams
teenode team list           # List all teams
teenode team use TEAM_ID    # Switch team

# Projects
teenode project list        # List projects
teenode project create      # Create new project
teenode project info ID     # Get project details

# Virtual Machines
teenode vm create ID        # Create VM
teenode vm info ID          # Get VM status
teenode vm start ID         # Start VM
teenode vm stop ID          # Stop VM
teenode vm console ID       # Get connection info

Need Help?

Get help for any command:
teenode --help
teenode COMMAND --help

For more detailed information, check out the CLI Reference or explore the Guides section.

NextInstallation