Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

docs: offline mode #555

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
Loading
Sorry, something went wrong. Reload?
Sorry, we cannot display this file.
Sorry, this file is invalid so it cannot be displayed.
59 changes: 59 additions & 0 deletions installation-and-setup/offline-mode.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,59 @@
---
title: Offline Mode
description: "Requesting, enabling, and using Fiddler's offline mode for environments with restricted internet access."
slug: fe-offline-mode
publish: true
position: 50
---

# Offline Mode

The offline mode in Fiddler Everywhere allows you to use the application’s core functionalities while working with limited or no internet access. The mode enables you to start the application without an explicit login and then configure the capturing you want to use - all without having active internet connection or while using restricted network. All options that can help you in your traffic debugging process are available offline, such as all Inspectors, Filters, Rules, Compare Sessions, and Composer.

## Prerequisites

- Requires licensed seat under the **Fiddler Everywhere Enterprise** subscription tier.
- Supported on Windows for both physical and virtual work machines.
- (Windows only) Requires Active Directory configuration with valid AD user (AD principal email).
- Supported on macOS with limited support for JAMF users only.

## Configuration Instructions

Execute the following steps to enable the offline mode:

1. Start Fiddler Everywhere on the device with limited internet access.

2. Upon login attempt, the Fiddler Everywhere application will display the "Something Went Wrong" screen. From that same screen, copy the information from the text field that contains details about the operating system and the user's principal email.

!["Something Went Wrong" screen on device with limited internet access](../images/offline/offline-mode-something-went-wrong-screen.png)

3. Send the above information to the support team alongside your [offline license request](#request-an-offline-license).

Once the request is received and approved, our team will reach out and send an individual offline license file that you must install on your device as follows:

- Download and install [the latest version of Fiddler Everywhere](https://www.telerik.com/download/fiddler-everywhere).

- Ensure that the Fiddler Everywhere application is closed.

- Open the archive **license.zip** (which you will receive from the support team) and extract the **license.lic** file. You will need only this file, not the archive itself.

* Instructions for **Windows** - Create and navigate to the following folder on your Windows PC/Server.

```sh
%PROGRAMDATA%/Fiddler/License
```

* Instructions for **macOS** - Create and navigate to the following folder on your macOS device.

```sh
~/Library/Application Support/Fiddler Everywhere/License
```

- Inside the **License** folder, place the **license.lic** file. Ensure the file has the name **license.lic**.

Finally, restart Fiddler Everywhere to use the offline mode for the currently logged user. Note that the logged user must be identical to the one specified as the user's principal email in your support request.

## Request an Offline license

The offline mode is explicitly enabled through an individual offline license file. To request your license file, contact the Fiddler Everywhere technical support team through the [Telerik's Support Center](https://www.telerik.com/account/support-center
) or contact us directly at [[email protected]]([email protected]). Your request should include the information from the second step in the [configuration instructions](#configuration-instructions) and the licensed user that holds a seat for the **Fiddler Everywhere Enterprise** subscription tier.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

"Your request should include the information from the second step in the configuration instructions and the licensed user that holds a seat for the Fiddler Everywhere Enterprise subscription tier."

I think you can improve this sentence. Right now I don't understand what information about the licensed user is needed. Is it the email of the licensed user, the one from their Telerik account, or something else?