• Stars
    star
    640
  • Rank 70,324 (Top 2 %)
  • Language
    Python
  • License
    MIT License
  • Created about 12 years ago
  • Updated about 2 months ago

Reviews

There are no reviews yet. Be the first to send feedback to the community and the maintainers!

Repository Details

Official uWSGI docs, examples, tutorials, tips and tricks

Note

The project is in maintenance mode (only bugfixes and updates for new languages apis). Do not expect quick answers on github issues and/or pull requests (sorry for that) A big thanks to all of the users and contributors since 2009.

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

Contributors for documentation (in addition to code) are always welcome.

Quickstarts

.. toctree::
   :maxdepth: 1

   WSGIquickstart
   PSGIquickstart
   RackQuickstart
   Snippets


Table of Contents

.. toctree::
   :maxdepth: 1

   Download
   Install
   BuildSystem
   Management
   LanguagesAndPlatforms
   SupportedPlatforms
   WebServers
   FAQ
   ThingsToKnow
   Configuration
   FallbackConfig
   ConfigLogic
   Options
   CustomOptions
   ParsingOrder
   Vars
   Protocol
   AttachingDaemons
   MasterFIFO
   Inetd
   Upstart
   Systemd
   Circus
   Embed
   Logging
   LogFormat
   LogEncoders
   Hooks
   WorkerOverride
   Glossary
   ThirdPartyPlugins

Tutorials

.. toctree::
   :maxdepth: 1

   tutorials/CachingCookbook
   tutorials/Django_and_nginx
   tutorials/dreamhost
   tutorials/heroku_python
   tutorials/heroku_ruby
   tutorials/ReliableFuse
   tutorials/DynamicProxying
   tutorials/GraphiteAndMetrics


Articles

.. toctree::
   :maxdepth: 1

   articles/SerializingAccept
   #articles/MassiveHostingWithEmperorAndNamespaces
   articles/TheArtOfGracefulReloading
   articles/FunWithPerlEyetoyRaspberrypi
   articles/OffloadingWebsocketsAndSSE
   articles/WSGIEnvBehaviour



uWSGI Subsystems

.. toctree::
   :maxdepth: 1

   AlarmSubsystem
   Caching
   WebCaching
   Cron
   Fastrouter
   InternalRouting
   Legion
   Locks
   Mules
   OffloadSubsystem
   Queue
   RPC
   SharedArea
   Signals
   Spooler
   SubscriptionServer
   StaticFiles
   SNI
   GeoIP
   Transformations
   WebSockets
   Metrics
   Chunked

Scaling with uWSGI

.. toctree::
   :maxdepth: 1

   Cheaper
   Emperor
   Broodlord
   Zerg
   DynamicApps
   SSLScaling

Securing uWSGI

.. toctree::
   :maxdepth: 1

   Capabilities
   Cgroups
   KSM
   Namespaces
   FreeBSDJails
   ForkptyRouter
   TunTapRouter


Keeping an eye on your apps

.. toctree::
   :maxdepth: 1

   Nagios
   SNMP
   PushingStats
   Carbon
   StatsServer
   Metrics


Async and loop engines

.. toctree::
   :maxdepth: 1

   Async
   Gevent
   Tornado
   uGreen
   asyncio



Web Server support

.. toctree::
   :maxdepth: 1

   Apache
   Cherokee
   HTTP
   HTTPS
   SPDY
   Lighttpd
   Mongrel2
   Nginx
   OpenBSDhttpd


Language support

.. toctree::
   :maxdepth: 2

   Python
   PyPy
   PHP
   Perl
   Ruby
   Lua
   JVM
   Mono
   CGI
   GCCGO
   Symcall
   XSLT
   SSI
   V8
   GridFS
   GlusterFS
   Rados

Other plugins

.. toctree::
   :maxdepth: 1

   Pty
   SPNEGO
   LDAP


Broken/deprecated features

.. toctree::
   :maxdepth: 1

   Erlang
   ManagementFlag
   Go


Release Notes

Stable releases

.. toctree::
   :maxdepth: 1

   Changelog-2.0.21
   Changelog-2.0.20
   Changelog-2.0.19.1
   Changelog-2.0.19
   Changelog-2.0.18
   Changelog-2.0.17.1
   Changelog-2.0.17
   Changelog-2.0.16
   Changelog-2.0.15
   Changelog-2.0.14
   Changelog-2.0.13.1
   Changelog-2.0.13
   Changelog-2.0.12
   Changelog-2.0.11.2
   Changelog-2.0.11.1
   Changelog-2.0.11
   Changelog-2.0.10
   Changelog-2.0.9
   Changelog-2.0.8
   Changelog-2.0.7
   Changelog-2.0.6
   Changelog-2.0.5
   Changelog-2.0.4
   Changelog-2.0.3
   Changelog-2.0.2
   Changelog-2.0.1
   Changelog-2.0
   Changelog-1.9.21
   Changelog-1.9.20
   Changelog-1.9.19
   Changelog-1.9.18
   Changelog-1.9.17
   Changelog-1.9.16
   Changelog-1.9.15
   Changelog-1.9.14
   Changelog-1.9.13
   Changelog-1.9.12
   Changelog-1.9.11
   Changelog-1.9.10
   Changelog-1.9.9
   Changelog-1.9.8
   Changelog-1.9.7
   Changelog-1.9.6
   Changelog-1.9.5
   Changelog-1.9.4
   Changelog-1.9.3
   Changelog-1.9.2
   Changelog-1.9.1
   Changelog-1.9



Contact

IRC #uwsgi @ irc.freenode.org.
Twitter https://twitter.com/unbit
Commercial support http://unbit.com/

.

Commercial support

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

Donate

uWSGI development is maintained by Unbit . 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.

Check http://unbit.it/uwsgi_donate for the donation link.

Sponsors

https://www.pythonanywhere.com/

https://lincolnloop.com/

https://yourlabs.io/oss

https://fili.com

Indices and tables

More Repositories

1

uwsgi

uWSGI application server container
C
3,459
star
2

vpn-ws

A VPN system over websockets
C
606
star
3

spockfs

SpockFS is an HTTP based network filesystem
C
307
star
4

foohid

OSX IOKit driver for implementing virtual HID devices (joypads, keyboards, mices, ...) from userspace
C++
264
star
5

django-uwsgi

Django related examples/trick/modules for uWSGI
Python
211
star
6

blastbeat

The BlastBeat server
C
159
star
7

uwsgi.it

The next-generation Unbit hosting platform
Python
77
star
8

uwsgi-docker

uWSGI plugin for integration with Docker
C
66
star
9

sftpclone

A tool for cloning/syncing a local directory tree with an SFTP server
Python
52
star
10

uwsgi-sentry

uWSGI plugin for sentry integration
C
49
star
11

uwsgi-realtime

a uWSGI plugin exposing offloaded realtime features like SSE, socket.io and media streaming
C
38
star
12

pysftpserver

An OpenSSH sftp wrapper in python
Python
36
star
13

uwsgi-consul

uWSGI plugin for consul integration
C
29
star
14

davvy

A Django application for building WebDAV services
Python
25
star
15

uwsgi-sse-offload

uWSGI offload bridge between redis pubsub and server sent events (sse)
C
23
star
16

librethinkdb

a c library for accessing rethinkdb servers
C
23
star
17

uwsgi-phpsgi

uWSGI experimental plugin for implementing a WSGI/PSGI/Rack-like interface for php
C
20
star
18

gitwhoosh

A git repository indexer (using whoosh as the engine)
Python
19
star
19

foohid-py

Python wrapper for the foohid OSX driver
C
18
star
20

spoolgore

A simple mail "spool and send" daemon written in Go
Go
14
star
21

uwsgi-rust

uWSGI and Rust integration plugin
Rust
13
star
22

uwsgi-pgnotify

Maps PostgreSQL notification system to uWSGI signal framework
C
11
star
23

unbit-bars

A Perl Curses::UI interface for uWSGI metrics subsystem
Perl
11
star
24

uwsgi-swift

uWSGI plugin for Apple Swift integration
Objective-C
10
star
25

uwsgi-bonjour

uWSGI plugin for OSX bonjour services integration
C
9
star
26

pydrone

run sandboxed javascript code in your python apps
C
8
star
27

uwsgi-capture

uWSGI plugin for accessing video capture devices
C
8
star
28

uwsgi-eventfd

uWSGI plugin for Linux eventfd() syscall integration
C
7
star
29

uwsgi-influxdb

uWSGI plugin for influxdb integration
C
7
star
30

uwsgi-wstcp

uWSGI plugin mapping websockets to tcp sockets
C
7
star
31

ulver

Unbit Lisp Version
C
7
star
32

uwsgi-node-rpc-server

A simple uwsgi-RPC server written in node.js
JavaScript
7
star
33

dockstrap

Like debootstrap but uses docker registry
Python
6
star
34

uwsgi-datadog

uWSGI plugin for datadog integration
C
6
star
35

uwebsocketconnection

an attempt to run websockets over uwsgi http router using gevent or uGreen
6
star
36

uwsgi-alarm-socket

uWSGI simple plugin for monitoring sockets
C
6
star
37

uwsgi-hetzner

A uWSGI legion action for managing hetzner's failover ip service
6
star
38

uwsgi-pushover

uWSGI plugin for sending pushover notifications (https://pushover.net/)
C
5
star
39

9spock

A high performance, featureful 9p fileserver for containers
5
star
40

uwsgi-apparmor

uWSGI integration with apparmor
C
4
star
41

uwsgi-riemann

uWSGI plugin for riemann integration
C
4
star
42

uwsgi-netlink

uWSGI plugin exposing netlink features
C
4
star
43

uwsgi-ganglia

uWSGI plugin for Ganglia integration
C
4
star
44

uwsgi-cares

uWSGI plugin for integration with the c-ares async dns library
C
3
star
45

uwsgi-gif

uWSGI plugin for dynamic generation of simple gif images
C
3
star
46

uwsgi-qtloop

Qt loop engine for uWSGI
C++
2
star
47

uwsgi-strophe

uWSGI plugin for libstrophe integration (xmpp)
C
2
star
48

uwsgi-java-servlet

experimental uWSGI plugin implementing java servlet 2.5
Java
2
star
49

unbit-docs

Documentazione per deployment su piattaforma Unbit
HTML
2
star
50

unbit.github.com

JavaScript
2
star
51

perl-net-uwsgi

perl module for easy interaction with uWSGI servers
Perl
2
star
52

uwsgi-alarm-chain

uWSGI plugin for mapping multiple alarms to a single event
C
2
star
53

aivengine

AIV Simple Game Engine for first year students
C#
2
star
54

pam-unbit

pam module for attaching to namespaced Emperors via setns()
C
1
star
55

moarvm-uwsgi-skel

A skel/base for building a uWSGI moarvm plugin aimed at NQP
C
1
star
56

uwsgi-opentsdb

uWSGI plugin for OpenTSDB integration
C
1
star
57

nss-unbit

nss module for the uwsgi.it service
C
1
star
58

uwsgi-quota

uWSGI plugin for UNIX quota integration
C
1
star
59

uwsgi-console-broadcast

uWSGI plugin exposing hooks for sending broadcast messages to terminals
C
1
star
60

blastbeat-gem

A Ruby module exporting a bunch of utility for integration with the BlastBeat server
Ruby
1
star
61

uwsgi-etcd

uWSGI plugin for etcd integration
1
star
62

uwsgicc

uWSGI Flask example app using the uwsgi api
Python
1
star