Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with
or
.
Download ZIP
Official uWSGI docs, examples, tutorials, tips and tricks
Python
branch: master

This branch is 360 commits behind unbit:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
_options
_tools
articles
examples
tips_and_tricks
tutorials
.gitignore
API.rst
AlarmSubsystem.rst
Apache.rst
Async.rst
AttachingDaemons.rst
Broodlord.rst
BuildSystem.rst
CGI.rst
CONTRIBUTORS
C_Api.rst
Caching.rst
Capabilities.rst
Carbon.rst
Cgroups.rst
Changelog-1.4.10.rst
Changelog-1.9.1.rst
Changelog-1.9.10.rst
Changelog-1.9.11.rst
Changelog-1.9.12.rst
Changelog-1.9.13.rst
Changelog-1.9.14.rst
Changelog-1.9.15.rst
Changelog-1.9.16.rst
Changelog-1.9.17.rst
Changelog-1.9.18.rst
Changelog-1.9.19.rst
Changelog-1.9.2.rst
Changelog-1.9.20.rst
Changelog-1.9.21.rst
Changelog-1.9.3.rst
Changelog-1.9.4.rst
Changelog-1.9.5.rst
Changelog-1.9.6.rst
Changelog-1.9.7.rst
Changelog-1.9.8.rst
Changelog-1.9.9.rst
Changelog-1.9.rst
Changelog-2.0.1.rst
Changelog-2.0.2.rst
Changelog-2.0.3.rst
Changelog-2.0.rst
Cheaper.rst
Cherokee.rst
Chunked.rst
Circus.rst
ConfigLogic.rst
Configuration.rst
Cron.rst
CustomOptions.rst
Download.rst
DynamicApps.rst
Embed.rst
Emperor.rst
EmperorProtocol.rst
Erlang.rst
FAQ.rst
FallbackConfig.rst
Fastrouter.rst
ForkptyRouter.rst
FreeBSDJails.rst
GCCGO.rst
GeoIP.rst
Gevent.rst
Glossary.rst
GlusterFS.rst
Go.rst
GridFS.rst
HTTP.rst
HTTPS.rst
Hooks.rst
ImperialMonitors.rst
Inetd.rst
Install.rst
InternalRouting.rst
JVM.rst
JWSGI.rst
KSM.rst
LDAP.rst
LanguagesAndPlatforms.rst
Legion.rst
Lighttpd.rst
Locks.rst
LogEncoders.rst
LogFormat.rst
Logging.rst
Lua.rst
Management.rst
ManagementFlag.rst
MasterFIFO.rst
Metrics.rst
Mongrel2.rst
Mono.rst
Mules.rst
Nagios.rst
Namespaces.rst
Nginx.rst
OffloadSubsystem.rst
Options.rst
PHP.rst
PSGIquickstart.rst
ParsingOrder.rst
Perl.rst
Protocol.rst
Pty.rst
PushingStats.rst
PyPy.rst
PyPy_benchmarks.rst
Python.rst
PythonDecorators.rst
PythonModule.rst
PythonModuleAlias.rst
PythonPump.rst
Queue.rst
README.rst
RPC.rst
RackQuickstart.rst
Rados.rst
Ring.rst
Ruby.rst
RubyAPI.rst
SNI.rst
SNMP.rst
SPDY.rst
SPNEGO.rst
SSI.rst
SSLScaling.rst
SharedArea.rst
Signals.rst
Snippets.rst
Spooler.rst
StaticFiles.rst
StatsServer.rst
SubscriptionServer.rst
SupportedPlatforms.rst
Symcall.rst
SystemD.rst
ThingsToKnow.rst
ThirdPartyPlugins.rst
Tornado.rst
Tracebacker.rst
Transformations.rst
TunTapRouter.rst
UpgradingTo2.0.rst
Upstart.rst
V8.rst
Vars.rst
WSGIquickstart.rst
WebCaching.rst
WebServers.rst
WebSockets.rst
XSLT.rst
Zerg.rst
conf.py
index.rst
uGreen.rst

README.rst

The uWSGI project

The uWSGI project aims at developing a full stack for building hosting services.

Application servers (for various programming languages and protocols), proxies, process managers and monitors are all implemented using a common api and a common configuration style.

Thanks to its pluggable architecture it can be extended to support more platforms and languages.

Currently, you can write plugins in C, C++ and Objective-C.

The "WSGI" part in the name is a tribute to the namesake Python standard, as it has been the first developed plugin for the project.

Versatility, performance, low-resource usage and reliability are the strengths of the project (and the only rules followed).

Included components (updated to latest stable release)

The Core (implements configuration, processes management, sockets creation, monitoring, logging, shared memory areas, ipc, cluster membership and the :doc:`SubscriptionServer`)

Request plugins (implement application server interfaces for various languages and platforms: WSGI, PSGI, Rack, Lua WSAPI, CGI, PHP, Go ...)

Gateways (implement load balancers, proxies and routers)

The :doc:`Emperor <Emperor>` (implements massive instances management and monitoring)

Loop engines (implement events and concurrency, components can be run in preforking, threaded, asynchronous/evented and green thread/coroutine modes. Various technologies are supported, including uGreen, Greenlet, Stackless, :doc:`Gevent <Gevent>`, Coro::AnyEvent, :doc:`Tornado <Tornado>`, Goroutines and Fibers)

Note

uWSGI is a very active project with a fast release cycle. For this reason the code and the documentation may not always be in sync. We try to make our best to have good documentation but it is an hard work. Sorry for that. If you are in trouble, the mailing list is the best source for help regarding uWSGI. Contributors for documentation (in addition to code) are always welcome.

Quickstarts

Table of Contents

Tutorials

Articles

uWSGI Subsystems

Scaling with uWSGI

Securing uWSGI

Keeping an eye on your apps

Async and loop engines

Web Server support

Language support

Other plugins

Broken/deprecated features

Release Notes

Stable releases

LTS releases

Contact

Mailing list http://lists.unbit.it/cgi-bin/mailman/listinfo/uwsgi
Gmane mirror http://dir.gmane.org/gmane.comp.python.wsgi.uwsgi.general
IRC #uwsgi @ irc.freenode.org. The owner of the channel is unbit.
Twitter http://twitter.com/unbit
Commercial support http://unbit.com/

.

Commercial support

You can buy commercial support from http://unbit.com

Donate

uWSGI development is sponsored by the Italian ISP Unbit and its customers. You can buy commercial support and licensing. If you are not an Unbit customer, or you cannot/do not want to buy a commercial uWSGI license, consider making a donation. Obviously please feel free to ask for new features in your donation.

We will give credit to everyone who wants to sponsor new features.

See the old uWSGI site for the donation link. You can also donate via GitTip.

Indices and tables

Something went wrong with that request. Please try again.