Camilla Proxy - Getting started#

Installation#

The installation process should be as easy as possible. By default you can start Camilla Proxy directly after installation.

Linux (Debian/Ubuntu)#

Installing Camilla Proxy on Debian/Ubuntu is done via the APT package manager.

wget -O - http://apt.camillaproxy.com/camillaproxy.gpg.key | sudo apt-key add -
sudo add-apt-repository "deb http://apt.camillaproxy.com/ trusty main"
sudo apt-get update
sudo apt-get install camilla

During installation Camilla Proxy registers itself to launch on boot and is started right after the installation process.

Mac OS#

Camilla Proxy does not run on Mac OS yet. However, you probably don’t need it anyway. If you run a Linux webserver, it’s better to install it there.

Windows#

Camilla Proxy does not run on Windows yet. However, you probably don’t need it anyway. If you run a Linux webserver, it’s better to install it there.

Testing Camilla Proxy#

After installation you can start proxying requests directly. To try your installation run the following command on the server you’ve just installed Camilla Proxy:

curl -x 127.0.0.1:8888 https://www.camillaproxy.com/

Congratulations, you made your first request via Camilla Proxy!

Using Camilla Proxy#

Camilla Proxy consists of two parts:

  1. A proxy server
  2. A visual dashboard

Using the dashboard#

The dashboard is where you can inspect the proxied requests real-time. You can see the dashboard by going to the following URL in your browser:

http://hostname:7777

(replace hostname with the server address you installed Camilla Proxy on)

The interface can be divided in two parts. On the left the HTTP sessions (1) are listed, and on the right you can find details on the request (2) and response (3) information. See the image below.

There is nothing listed in your session list yet, so let’s make another HTTP request via Camilla Proxy by running:

curl -x 127.0.0.1:8888 https://www.camillaproxy.com/

You will now see the request in the session list.