AdTrap: AdTrap Anywhere on OS X

AdTrap: AdTrap Anywhere on OS X

Requirements For This Walkthrough


  1. Mac running OS X
  2. AdTrap with AdTrap Anywhere enabled


  1. None.

Knowledge, Skills, and Abilities

  • Knowledge of basic computer terminology
  • Familiarity with core networking concepts/terms
  • Ability to adjust network settings in OS X


AdTrap Anywhere

Enable AdTrap Anywhere

Assuming your AdTrap is already up and running, the Anywhere feature needs to be enabled via the Web interface.  You need to be on the same network that your AdTrap is on to adjust these settings.

1. Navigate to adtrap.local:10001 in a Web browser

2. Click Settings > AdTrap Anywhere

3. Choose Enabled from the pull-down menu

4. Enter a username and secure password

5. Click Save

6. Take note of the unique domain name that is generated

Create Two New Network Locations as Duplicates of “Automatic”

OS X can have multiple network “locations,” which allow for different settings.  This is useful for the AdTrap so one location can be set for your home network, while the other can be set for when you are away.

Create A Local and Global AdTrap Network Location

  1. Open System Preferences > Network
  2. Choose Edit Locations from the pulldown menu labeled Locations
  3. Highlight Automatic
  4. Choose Duplicate Service from the pulldown menu
  5. Create two new locations: AdTrap Local and AdTrap Global

Set the Proxy Settings for AdTrap Global Locations

1. Select AdTrap Global as the current location within Network Preferences

2. Click Advanced

3. Click the Proxy tab

4. Fill in the information as pictured below from the AdTrap Anywhere Web interface

5. Click OK

6. Click Apply

Forward Port 5555 to the AdTrap

This step will vary based on your router, but you can get the basic idea from this post.

Connect to Another Network to Test the Global connection

1. Select the AdTrap Global network location from the Apple menu

2. Navigate to a Website

3. Enter the username/password entered when the AdTrap Anywhere feature was set up when the prompt appears

This seems to work most of the time, but every once in a while, the prompt re-appears.  To avoid this from happening, you might need to adjust some settings in the Keychain entry.

Adjust Keychain to Avoid Typing in Password Every Time

1. Open Keychain Access

2. Highlight login in the upper-sidebar

3. Highlight Passwords in the lower-sidebar

4. Double-click the entry for on the right side of the window

5. Click the Access Control tab

6. Select the radio button to Allow all applications access to this item

7. Alternatively, click the plus sign to add specific applications

Testing AdTrap Anywhere for Functionality

Use Traceroute

  1. Select a network location that is not AdTrap Global, while you are on a network that is not your own (a network away from home)
  2. Open Terminal
  3. Type ping (or any Website) and let the command complete
  4. Select the AdTrap Global network location now
  5. Type ping again
  6. Compare the output of the two commands
  7. They should be different and you will probably see entries for your ISP or places near your home
  8. If you got this far int he walkthrough, it is probably working already, but it is still nice to see it in effect