Skip to content


Subversion checkout URL

You can clone with
Download ZIP
Real Time Proxy
Pull request Compare This branch is 1 commit behind facebookarchive:master.
Fetching latest commit...
Cannot retrieve the latest commit at this time.
Failed to load latest commit information.


=== Facebook Graph Proxy with Realtime Invalidation ===
The Facebook Graph Proxy is a simple proxy for that takes
advantage of the Realtime Updates feature to invalidate stale data. It can be
used by replacing references to with references to the

== Installation ==
To install:

    python build
    sudo python install

The Facebook Graph Proxy also requires the CherryPy WSGI server to function.
This may be installed using:

    sudo easy_install cherrypy

== Configuration ==
To start, copy config.sample into config.txt. From here, you will need to
update the following values:

    proxy_port: the port on which the server will listen for requests which
                need to be proxied.
    realtime_port: the port on which the server will listen for Realtime
                   Updates from Facebook.
    cache_entries: The number of entries that should be stored in the cache
                   before dropping the least-recently-used entry
    public_hostname: The publicly-visible hostname that Facebook should use
                     to reach the Realtime Update endpoint of this server

In addition, you will need to enter information about the Facebook
Applications which will be using this server. See the config file for details.

== Security Considerations ==
In order to avoid leaking data about users, the proxy port must only be
accessible by your own servers.

== Execution instructions ==
To run the proxy:

  start_proxy [config_file]

If config_file is not passed, then the proxy will default to using config.txt.

Something went wrong with that request. Please try again.