CherryPy official documentation

This website contains the official documentation for the most recent, stable version of CherryPy. Compatibility info for older versions is included at the bottom of each page. For versions 2.1 and 2.2 of CherryPy, you can find more reference material in the OldDocs.

See Publications for links to books and online articles.

Translations

• Spanish (Incomplete translation)

Table of Contents

• Tutorial (start here)
  • CherryPyTutorial
  • CherryPyTutorialFrench
  • CherryPyTutorialIta
  • CherryPyTutorialSpanish
• Installation
  • CherryPyDownload
  • CherryPySubversionRepository
• ApplicationReference
  • The Request Cycle
    • • PageHandlers
      • RequestObject
      • ResponseObject
      • BuiltinTools
      • CustomTools
      • ErrorsAndExceptions (including redirects)
  • Everything Else
    • • EngineObject (see also WebSiteProcessBus)
        • BuiltinPlugins
          • AutoReload
          • Daemonization
        • CustomPlugins
      • ServerObject
      • ApplicationObject
      • ConfigAPI
      • Logging
      • Testing
  • APIDocs
• HOWTO's. There are many more applications and examples on the Tools wiki.
  • Caching
  • ChoosingATemplatingLanguage
  • Cookies
  • Favicon
  • FileDownload
  • FileUpload
  • ModPython
  • DeployTemplate (for foreign HTTP servers like mod_python)
  • ReturnVsYield
  • rfc2617
  • CherryPySessions
  • StaticContent
  • WSGI
  • WSGIServeMulipleApplications
• Specifications and API's
  • ServerAPI
  • CherryPySpec
  • WSPBSpec
  • gzip
• Known Issues
  • CherryPyBrokenPipe
  • ProfilingOnDebian
  • UsingCOMObjects
• The CherryPy Project
  • CodeConventions
  • FAQ
  • CherryPyInvolved
  • CherryPyLicense
  • NewsArchive
  • PackageStrategy
  • ReleaseProcess
  • SuccessStories
  • CherryPyTeam
    ChristianWyglendowski? SylvainHellegouarch
  • UserTestimonials
  • WhyCherryPy
  • ZenOfCherryPy
• Upgrades
  • UpgradeTo20
  • UpgradeTo21 WhatsNewIn21
  • UpgradeTo22 WhatsNewIn22
  • UpgradeTo30 WhatsNewIn30
  • UpgradeTo31 WhatsNewIn31
• Contact
  • CherryPyIrcChannel
  • IRC Sessions: 2004: Nov 06 Nov 16 2005: Jan 10 Feb 09 Apr 12 May 10 May 19
• Miscellaneous
  • ExposeItems
  • HostingProviders
  • PositionalParameters
  • CherryPyAndPaste
  • CherryPyAndPasteCanPlayNice
  • CherryPySpeed
• Old Content
  • ConfigFile20
  • OldDocs
  • StdFilterBaseUrl
  • StdFilterDecoding
  • StdFilterEncoding
  • StdFilterGzip
  • StdFilterLogDebug
  • StdFilterTidy
  • StdFilterVirtualHost
  • StdFilterXmlRpc
  • VirtualPathFilter