Documentation µweb - installation

µWeb is developed on, and intended primarily to run on Debian GNU-Linux. As such, installation instructions will focus on getting µWeb running on that family of platforms


The easiest way to install µWeb is to get it from the Python Package Index ( For most Linux there is a commandline application pip which facilitaties easy installation of packages from the Package Index. To begin, install pip on Debian:

sudo apt-get install python-pip

After this, µWeb can be installed with the following command:

sudo pip install uweb

This pulls in all the necessary requirements automatically and installs and configures them for you.

MySQL support

µWeb requires a MySQL connector binary, which pip will attempt to compile from source for you. If this is undesired (because it requires development headers for MySQL and Python, and some other packages), this MySQL requirement can be fulfilled by installing that package separately:

sudo apt-get install python-mysqldb


The easiest way to upgrade µWeb to the latest release is to use pip again:

sudo pip install --upgrade uweb

This will also automatically update all dependencies of µWeb if they have changed. If you run into missing dependencies for the MySQL connector (as explained in the section above, MySQL support), the easiest way to perform the upgrade is to remove and reinstall in one go:

sudo pip uninstall uweb && sudo pip install uweb

Installation on OS X 10.9

Install Homebrew ( or update:

brew update


brew doctor

and fix any issues.

Install mySQL:

brew install mysql

Install pip:

sudo easy_install pip

Set flags prior to installing uWeb to prevent Clang error (see this page for further info:

export CFLAGS=-Qunused-arguments; export CPPFLAGS=-Qunused-arguments

Now install uWeb:

sudo -E pip install uweb
blog comments powered by Disqus