This site is migrating to wiki.safing.io, which is being maintained by Safing and the community alike.

Overview

  1. Introduction
  2. Portmaster Core Service
  3. Portmaster User Interface
  4. Notifier
  5. OS Integration / Kernel Extension

Introduction

Before diving into details it is important to understand the big picture. As any machine, the Portmaster Application has many parts and gears that have to work together seamlessly to deliver the privacy you deserve. Take a look:

Portmaster Architecture Overview

Portmaster Core Service

The Portmaster Core Service is where all the magic happens. It consistently runs in the background, tirelessly protecting your privacy and keeping tabs on everything that is going in and out of your system. As a system service it starts together with your device and ensures your privacy from the second you start working.

The Portmaster Core Service is divided into modules, which allows you to easily adapt the Portmaster Application to your preferences and threat model. You can dive deeper into each Module and explore its underlying tech.

*Mandatory Module

Portmaster User Interface

The Portmaster UI is the main way you interact with the Portmaster Application. It connects to the Portmaster Core Service, which is running in the background. Through the Portmaster UI you can easily monitor network activity on your device, block domains and connections as well as configure settings and rules.

The Portmaster UI has no background activity in order to save your precious computing resources. Background interaction is being take care of the Notifier.

Extended documentation of the Portmaster UI are yet to be written. You can check out its source code in the mean time.

Notifier

The Notifier is a small utility that lives in your system’s tray or menu bar. It continually signals you the status of the Portmaster Core Service via colored status indicators in the icon. If you have Desktop Notifications enabled, the notifier takes care of relaying them to your operating system.

You do not have to open the full Portmaster UI for more details or to make changes: If something goes wrong, you can get a first impression of what is going on by clicking the icon to open the menu. There you can quickly react to changed circumstances and switch your network rating.

Extended documentation of the Notifier are yet to be written. You can check out its source code in the mean time.

OS Integration / Kernel Extension

The Portmaster Core Service cannot do all this magic by itself. It works closely together with the Operating System’s Core - the Kernel.

On Windows, this even requires that one part of the Portmaster Application runs directly within the OS Kernel itself, making it very powerful.

Dive into how the how the Portmaster Application integrates with different Operating Systems.