> For the complete documentation index, see [llms.txt](https://www.requestranger.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://www.requestranger.com/getting-started/setup-and-configuration.md).

# Setup and Configuration

This page will help you set up and configure Request Ranger to suit your needs and ensure that you get the most out of the application. Follow the steps below to customize your proxy settings, manage app preferences, and tailor Request Ranger to your specific requirements.

## **1. Install Request Ranger**

Before you can set up and configure Request Ranger, you must install the application on your macOS or iOS device. You can do this by downloading it from the [Apple App Store](/getting-started/installation/install-from-the-apple-app-store.md), or by following the [Installation guide](/getting-started/installation.md) to download the latest release from GitHub or build the application yourself.

## **2. Launch Request Ranger**

Once installed, open Request Ranger on your macOS or iOS device. The application will open to the main window, displaying the "Proxy" tab by default.

## **3. Configure Proxy Settings**

To start using Request Ranger, you'll need to configure your proxy settings:

1. In the "Proxy" tab, click on "Start Proxy" to enable the proxy server.
2. Take note of the proxy server address and port displayed in the application (e.g., `localhost:8080`).
3. Configure your web browser to use the proxy server address and port provided by Request Ranger. The process for doing this varies depending on the browser you're using. We recommend using Firefox for testing, as it supports HTTP and HTTPS proxies at the application level.

## **4. Manage App Preferences**

Access Request Ranger's preferences to customize the application to your needs:

1. In the macOS menu bar, click on "Request Ranger" and select "Preferences" from the dropdown menu.
2. In the Preferences window, you can adjust settings such as the proxy server port, appearance, and more.

## **5. Configure Security Settings (Optional)**

Request Ranger is designed with security in mind, but you can further enhance your security by taking the following steps:

1. Use a separate browser profile for testing to isolate your proxy sessions from your regular browsing activities.
2. Regularly review and update your proxy settings to ensure they remain secure and effective.
3. Stay up-to-date with the latest Request Ranger releases and apply security patches as needed.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://www.requestranger.com/getting-started/setup-and-configuration.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.