The test-tcell Developer Hub

Welcome to the test-tcell developer hub. You'll find comprehensive guides and documentation to help you start working with test-tcell as quickly as possible, as well as support if you get stuck. Let's jump right in!

Search results for "{{ search.query }}"

No results found for "{{search.query}}". 
View All Results

Quick Start Guide

This guide should get you started with tCell


When your company has been created, you should have been created a login. If you did not receive a login email, please contact

The URL for your company should be https://<yourcompany>

You will see two ways of logging in, via Google, or via email and password. Unless you've been instructed to otherwise, login via your email and password. (the Google auth is deprecated)

Creating Your First App

tCell monitors and protects your applications. Creating an App within tCell enables it to know that all the data that is coming to it from the agents are all associated with a single app instance.

For starters, create an application called "My Test App" by going to Admin > Applications, entering in "My Test App," in the box, and clicking Add.

After you have created your App, you should see it in table below. Note that every App has a unique "Application Id" that is used throughout the system.

Installing Server Agent (Rails Example)

This Quick Start will assume Rails is your application server.

To setup, go to Server Agent > Download Agent > Server Agent > Ruby, then follow the instructions in the UI. When you startup your application, you should see a directory ./tcell created with some files in there.

If you have a special download for the Ruby Agent (i.e. not instructed to use what's off of, see instructions here:

Starting your Application

You should now be able to start your application, and you should be able to see some initial data go to tCell via the dashboard.

On the side bars, there are sparklines indicating data being ingested by the tCell service from the agents. As you navigate the application, you should see activity in the XSS panel, and in the Server Agents panel you should see "Up" have a value of 1.

Sanity Checks

Some simple checks can be performed to see if things are not working properly.

1) Check via the browser to see if there are CSP headers in the response body from the application.

2) Check via the browser to see if JSAgent is being loaded in page.

3) Check to see if there are any recent writes to the ./tcell directory in your Rails project.

Quick Start Guide

This guide should get you started with tCell