Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
Official uWSGI docs, examples, tutorials, tips and tricks
branch: master

This branch is 1821 commits behind unbit:master

Fetching latest commit…

Cannot retrieve the latest commit at this time

Failed to load latest commit information.
_options
_tools
examples
tips_and_tricks
tutorials
.gitignore
AlarmSubsystem.rst
Apache.rst
Async.rst
AttachingDaemons.rst
Broodlord.rst
CGI.rst
Caching.rst
Capabilities.rst
Carbon.rst
Cgroups.rst
Cherokee.rst
ConfigLogic.rst
Configuration.rst
Cron.rst
CustomOptions.rst
Download.rst
DynamicApps.rst
Embed.rst
Emperor.rst
EmperorProtocol.rst
Erlang.rst
FAQ.rst
Fastrouter.rst
Gevent.rst
Glossary.rst
Go.rst
HTTP.rst
HTTPS.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
Lua.rst
Management.rst
ManagementFlag.rst
Mongrel2.rst
Mules.rst
Nagios.rst
Namespaces.rst
Nginx.rst
OffloadSubsystem.rst
Options.rst
PHP.rst
Perl.rst
Protocol.rst
PushingStats.rst
Python.rst
PythonDecorators.rst
PythonModule.rst
PythonModuleAlias.rst
PythonPump.rst
Queue.rst
README.rst
RPC.rst
Ruby.rst
RubyAPI.rst
SNMP.rst
SSLScaling.rst
SharedArea.rst
Signals.rst
Spooler.rst
StatsServer.rst
SubscriptionServer.rst
ThingsToKnow.rst
Tracebacker.rst
Upstart.rst
Vars.rst
WebServers.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 (and hosting) clustered/distributed network applications.

Mainly targeted at the web and its standards, it has been successfully used in a lot of different contexts.

Thanks to its pluggable architecture it can be extended without limits 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 SubscriptionSystem)

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 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>`, Goroutines and Fibers)

Note

With a large open source project such as uWSGI the code and the documentation may not always be in sync. The mailing list is the best source for help regarding uWSGI.

Table of Contents

uWSGI Subsystems

Scaling with uWSGI

Securing uWSGI

Keeping an eye on your apps

Async and loop engines

Web Server support

Language support

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

.

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.