Getting Started with easySIPp

Learn the basics of easySIPp and run your first SIP test in minutes

⏱️ 8 min read 🟢 Beginner

Introduction

easySIPp is a comprehensive web platform for SIPp that makes SIP/VoIP testing accessible through an intuitive interface. This tutorial will guide you through installing easySIPp and running your first test.

Prerequisites

Before you begin, make sure you have:

Installation Methods

Method 1: Docker Installation (Recommended)

Quick Start - Initial installation

Docker provides the fastest and easiest way to get started with easySIPp. All dependencies are included in the container.

Step 1: Pull the latest easySIPp Docker image:

docker pull krndwr/easysipp:latest

Step 2: Run the container:

docker run -dt --network host --name easysipp krndwr/easysipp

This creates a docker container with name easysipp - as it was passed in --name easysipp flag.

Command Breakdown:

Step 3: Access the web interface:

Open your browser and navigate to http://localhost:8080 or http://<ip-of-your-linux-system>:8080

Note: The --network host flag allows easySIPp to access your network interfaces directly, which is necessary for SIP testing.

Daily Usage

Start container (after stopping or reboot)

docker start easysipp

Stop container

docker stop easysipp

Update to Latest Version

Warning: Running docker rm easysipp will permanently delete existing data from the easysipp container including modified or uploaded XML files. Consider backing up important files first.

docker stop easysipp
docker rm easysipp     # All existing data (like your modified or uploaded xml files) will be lost
docker pull krndwr/easysipp:latest
docker run -dt --network host --name easysipp krndwr/easysipp

Complete Removal

docker stop easysipp
docker rm easysipp     # All existing data (like your modified or uploaded xml files) will be lost
docker rmi krndwr/easysipp

Understanding the Interface

When you first access easySIPp, you'll see the main dashboard with two panels:

UAC (User Agent Client) Panel

The left panel configures the calling party:

UAS (User Agent Server) Panel

The right panel configures the receiving party:

Running Your First Test

Simple UAC Test

Let's run a basic test where easySIPp acts as a UAC making calls to a SIP server:

Step 1: Configure the UAC panel:

Step 2: Click the second small icon (≡) next to select UAC XML option to visualize the test

This shows you the SIP message sequence that will be executed.

Step 3: Click "Run UAC" to start the test

You'll see the running sipp process on the section below it. You can click on "CheckOutput" button for real-time output showing the test progress and results, along with the control buttons.

UAC + UAS Test

For a complete test with both calling and receiving parties:

Step 1: Configure UAC panel as above

Step 2: Configure UAS panel:

Step 3: Click "Run UAS" first, then "Run UAC"

Best Practice: Always start the UAS before the UAC so it's ready to receive calls.

Monitoring and Controlling Your Tests

Once your test is running, you can see the running SIPp processes in the bottom half of the dashboard. Each running SIPp procces also has a "Kill" button and a "CheckOutput" button.

Upon clicking the "CheckOutput" button, a new page will be opened, which shows -

Common Issues and Solutions

Issue: Cannot access easySIPp web interface

Solution: Check that the Docker container is running:

docker ps | grep easysipp
# If container not running, start it using below
docker start easysipp

Issue: All calls fail immediately

Solution: Check:

Next Steps

Now that you've run your first test, explore these topics:

Summary

In this tutorial, you learned:

You're now ready to start testing your SIP infrastructure with easySIPp!

← Back to
All Tutorials
Next Tutorial →
Creating XML Scenarios