Skip to content

HTTPS clone URL

Subversion checkout URL

You can clone with HTTPS or Subversion.

Download ZIP
branch: master
Fetching contributors…

Cannot retrieve contributors at this time

74 lines (67 sloc) 3.236 kb

Setting up a development server

Setting up a development server is important if you want to help with the development of upTee.

Installation

Install all requirements

Be sure to install all requirements shown in the README.
In case the command pip is not available after installing setuptools run the following command:

$ easy_install pip

Switch into the uptee directory and run the following command:

$ pip install -r requirements.txt

If an error appears install the missing packages. The error messages are obvious.
In windows download packages which fails from here. Repeat the command until the installation finishes successfully!
If there are still problems with some modules have a look at the Troubleshooting section.

Set up the project

Switch into the uptee directory.
To set up the project copy the settings_local.py.example and rename the new file to settings_local.py.
Now edit the settings how u like. You can find an example for a development server here.
Copy browscap.csv.example and rename the new file to browscap.csv.

Install the database

$ python manage.py syncdb

It will ask to create a Superuser. Do not do that!

$ python manage.py migrate

Now create the Superuser.

$ python manage.py createsuperuser

Set up the port map

The port map is a list of available ports for the teeworlds servers. Be sure that the ports are not blocked by a firewall.

$ python manage.py create_portmap 8300 8320

This command adds the ports 8300 till 8320 to upTee. Decide yourself which ports you want to use and how many you need.

Start up the server

You will have to run two processes for starting up the Server.
First you have to run the celery worker and celerybeat (start as background process or two sessions).

$ python manage.py celery worker --loglevel=info
$ python manage.py celery beat

Be sure that the broker for celery is running (RabbitMQ is recommended).
If the example settings_local.py is used the database will be used.
After celery is running, run the server itself.

$ python manage.py runserver

The website is now available under http://localhost:8000/

Troubleshooting

error: Unable to find vcvarsall.bat

Some modules need a C/C++ compiler to build parts of the module for performance reasons.
In windows it may happen that it will not find the compiler or it might be even not installed.
If this is the case just download module from here and install it. After the installation you may still get the same error.
Just comment out the concerned module in the requirements.txt.
Example:

# PIL>=1.1.7
Jump to Line
Something went wrong with that request. Please try again.