Getting Started

Get up and running with Trusted Server quickly.

Prerequisites

Before you begin, ensure you have the following installed (versions are pinned in .tool-versions):

• Rust 1.95.0
• NodeJS 24.12.0
• Fastly 15.1.0 CLI installed
• A Fastly account and API key
• Basic familiarity with WebAssembly

Installation

Clone the Repository

git clone https://github.com/IABTechLab/trusted-server.git
cd trusted-server

Fastly CLI Setup

Install and configure the Fastly CLI using the Fastly setup guide.

Install Viceroy (Test Runtime)

cargo install viceroy --version 0.17.0 --locked --force

Local Development

Build the Project

cargo build

Run Tests

cargo test

Start Local Server

fastly compute serve

The server will be available at http://localhost:7676.

Configuration

Edit trusted-server.toml to configure:

• Ad server integrations
• KV store mappings
• EC configuration
• GDPR settings

See Configuration for details.

Deploy to Fastly

fastly compute publish

Next Steps

• Learn about Edge Cookies
• Follow the EC Setup Guide
• Understand GDPR Compliance
• Configure Ad Serving