Skip to main content
This is a pre-production deployment of Warehouse. Changes made here affect the production instance of PyPI (
Help us improve Python packaging - Donate today!

Application level proxy server

Project Description

**Application level proxy server**

Outpost combines proxy, static file serving and application
framework functionality in a single server application.

Advanced options include request debugging and stream filter.

Outpost also supports local javascript application development
in combination with remote web api services. The build in proxy
prevents browsers `Cross Origin Resource Scripting` restrictions
by routing all requests through a single (local) address. In combination
with Chrome or Firefox browsers build in developer tools
Outpost gives a additional option to debug, alter and trace outgoing
and incoming requests before being processed by the browser (or after the
request has been send). Single requests can be stopped based on url
schemes and debugged on the commandline.

Implemented in pure python; with the pyramid web framework.

Please refer to Github for source codes:


- Serves static files from a directory
- Routes webservice requests through the proxy
- Session and cookie support for proxied requests
- Custom filter support
- Single and multiple concurrent connections
- Interactive request hacking and tracing
- Easy installation, runs on any os

Configuration - Basic setup

All configuration options are set in `server.ini` in projects' home folder.

The directory to be served. Either a python module asset path, relative path
or absolute path :: = /home/me/myfiles
server.defaultfile = index.html

The domain to connect to. Ajax calls and urls can use a domain
placeholder to be inserted by outpost before proxying the request.
By default the placeholder is '__domain'. The string will
replaced with the following configuration setting. ::

proxy.domain =

The url prefix used to route request through the proxy. By default
urls starting with `` will be handled by the
proxy ::

proxy.route = __proxy


Short installation description:

- Install Python
- Install Python setuptools and virtualenv
- Create a virtual environment (virtualenv) directory named ‘outpost’ (or use your projects name)
``virtualenv outpost``
- Install outpost from ``bin/pip install outpost``
- Create a new project by using the scaffold ``bin/pcreate -t outpost myApp``
- change into myApp directory ``cd myApp``
- Start the web server ``../bin/pserve server.ini`` (the served directory path is relative)

If you are using a relative directory please make sure you start the webserver from the right
working directory.

Debug Toolbar

You can also use the pyramid debug toolbar to get a request log in the browser.
To enable the toolbar open the ini file and set ``debugtoolbar.enabled = true``

Setting a breakpoint

Change the line in your ini file to match proxied urls you would like to halt and inspect. ::

proxy.trace = signin

Each proxied url containing `signin` will be interrupted and can be inspected in the python debugger
on the commandline.

Basic commands (Take a look at python debugger for all commands):

- n : next step
- c : continue execution

Once you are in the debugger you can print the current requests values and change them (e.g. headers):

- method : http method
- url : the url to send the request to
- **parameter : a dictionary including headers and form values

after receiving the response

- response
- response.headers
Release History

Release History

This version
History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


History Node


Download Files

Download Files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
outpost-0.3.4.tar.gz (20.2 kB) Copy SHA256 Checksum SHA256 Source Aug 9, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting