~ubuntu-branches/debian/sid/coturn/sid

1) FreeBSD (and PC-BSD) have this project as a "port", named "turnserver",

in /usr/ports/net/turnserver directory. Installation is very simple:

 

# optional commands, to update the ports tree:

  $ sudo portsnap fetch 

  $ sudo portsnap update

 

# Build and install the TURN Server: 

  $ cd /usr/ports/net/turnserver

  $ sudo make install clean

  

2) Debian "jessie" (and the recent version of Ubuntu and Mint)  

have the predecessor of this project packaged as "rfc5766-turn-server", see the link:

 

http://packages.qa.debian.org/r/rfc5766-turn-server.html

 

In the new Debian "jessie", and in the related Ubuntu and Mint, you will 

be able to just select rfc5766-turn-server from the packages list and 

install it through Synaptic or through the package manager.

 

If you are using the Debian package from the project download site, then follow these instructions:

3) ArchLinux has this TURN server package:

4) OpenSUSE has an older package, too:

 

https://build.opensuse.org/package/show/home:ehauenstein/rfc5766-turn-server

 

If you are using a pre-packaged TURN server then you can skip 

to the section IX. 

By default, the generated Makefile will be set to install everything

in:

The binaries will be copied in bin subdirectory of the installation 

destination, config files copied to etc subdirectory. There will be 

 You can change the root configured destination directory by 

setting BINDIR, CONFDIR, MANPREFIX, EXAMPLESDIR, DOCSDIR, LIBDIR, SCHEMADIR

and TURNINCLUDEDIR variables in the 

The script configure is a proprietary script. It will create a Makefile 

The programs can be either called directly, or a shell scripts can be used. 

directory, successfully, without installing the TURN server into the system. 

 PREFIX/share/turnserver/ 

set for the binaries linking (if your compiler allows that option). If that 

is not desirable (like in some OS packaging procedures), then run the 

"configure" script with --disable-rpath option.

If you do not want to use the rpath linking option, or you OS or compiler 

do not allows that, then after the installation, you may have to adjust the 

system-wide shared library search path by using "ldconfig -n <libdirname>" 

(Linux), "ldconfig -m <libdirname>" (BSD) or "crle -u -l <libdirname>" 

(Solaris). Your system must be able to find the libevent2, openssl and 

(optionally) PostgreSQL and/or MySQL (MariaDB) and/or MongoDB and/or Redis 

shared libraries, either with the help of the system-wide library search 

configuration or by using LD_LIBRARY_PATH. "make install" will make a 

non-garantied effort to add automatically PREFIX/lib and /usr/local/lib to 

the libraries search path, but if you have some libraries in different 

non-default directories you will have to add them manually to the search 

path, or you will have to adjust LD_LIBRARY_PATH.

The following platforms have been used in the development:

 

        - Linux Ubuntu 11.x and 12.x, i386 and x86_64

        - FreeBSD 6.x, i386

        - FreeBSD 8.x, i386

        - PC-BSD 9.x, x86_64

        - Solaris 11, x86_64

        - Linux CentOS / Red Hat Enterprise Edition 6.x-7.0, x86_64 (i386 & amd64)

        - Linux Debian 'Squeeze', i386

        - Linux Mint 14.1 'Nadia', i386

        - Linux Mint 16 'Petra', i386

        - Linux Debian 'Wheezy', x86_64 

        - Cygwin 1.7.20

        - NetBSD 6.0.1, i386

        - OpenBSD 5.3, i386

        - Amazon Linux, x86_64

        - Mac OS X Mountain Lion

        - ArchLinux, x86_64

        - Fedora 19 and 20, x86_64

        - OpenSUSE 12.3, x86_64

 

It must work on many other *NIXes, as well. The configure script and/or 

        - gcc 3.4.4 thru 4.8.1

        - Solaris Studio 12.3 C compiler, version 5.12

It may be compiled with others compilers, too.

or better) are required, the PostgreSQL C client development setup is 

optional, the MySQL (MariaDB) C client development setup is optional, the MongoDB

C Driver and the Hiredis development files for Redis database access are optional.

For fully functional build, the extra set of libraries must be installed

in full version (the development headers and the libraries to link with). 

For runtime, only runtime setup is required. If the build is modified for 

OpenSSL, libevent2, PostgreSQL, MySQL (or MariaDB) and Hiredis 

Most modern popular systems (FreeBSD / PC-BSD, Linux Ubuntu 11.10+, Debian Wheezy, 

Linux Mint 14+, Amazon Linux, Fedora) have a simpler way of the third party tools 

installation:      

        *) PC-BSD or FreeBSD (the FRESH ports database is assumed to be installed, with

        **) Linux Ubuntu 11.10+, Debian Wheezy, Mint 14+:

        - mongo-c-driver packages are not available. MongoDB support 

  will not be compiled, unless you install it "manually" before 

  the TURN server compilation. Refer to https://github.com/mongodb/mongo-c-driver

  for installation instructions of the driver.

        *****) Some OSes in Debian family (Debian Squeeze and 

        pre-11.10 Ubuntus) setups are similar to Debian Wheezy, 

        although some packages have different names. 

You may also have to adjust the turn server start script, add PostgreSQL 

and/or MySQL and/or MongoDB and/or Redis runtime library path to LD_LIBRARY_PATH.

Or you may find that it would be more convenient to adjust the 

For exmple, the MySQL dynamic library may need that adjustment. You will have to use 

3) After the compilation, you can use the same tool, "adjust_name_tool", with option -change,

to adjust the library paths values in the binary, where necessary. All library paths must be 

absolute paths or @rpath/... .

NOTE: See "PostgreSQL setup" and "MySQL setup" and "MongoDB setup" and 

"Redis setup" sections below for more database setup information.

NOTE: If you do not install PostgreSQL or MySQL or MongoDB or Redis then you will

be limited to flat files for user database. It will work great for 

smaller user databases (like 100 users) but for larger systems you 

will need PostgreSQL or MySQL or MongoDB or Redis.

IX. TEST SCRIPT SETS

First of all, we can use test vectors from RFC 5769 to double-check that our 

additions. The best option is to install a good fresh openssl development 

library, free of Apple tweaks, from http://www.openssl.org. But the "native"

openssl will work, too.

XIV. PostgreSQL setup

 

The site http://www.postgresql.org site has excellent extensive documentation. 

For a quick-start guide, you can take a look into this page: 

http://www.freebsddiary.org/postgresql.php. That page is written for 

FreeBSD users, but it has lots of generic information applicable to other 

*NIXes, too.

 

For the psql-userdb TURN server parameter, you can either set a PostgreSQL 

connection string, or a PostgreSQL URI, see the link:

 

For 8.4 PostgreSQL version:

http://www.postgresql.org/docs/8.4/static/libpq-connect.html

 

For newer 9.x versions: 

http://www.postgresql.org/docs/9.2/static/libpq-connect.html#LIBPQ-CONNSTRING.

 

In the PostgreSQL connection string or URI, you can set the host, the 

access port, the database name, the user, and the user password 

(if the access is secured). Numerous other parameters can be set, 

see the links above. The TURN server will blindly use that connection 

string without any modifications. You are responsible for the right 

connection string format.

 

Below are the steps to setup the PostgreSQL database server from scratch:

 

1) Install PostgreSQL server.

 

2) Find and edit Postgres' pg_hba.conf file to set the access options 

(see docs). On different systems, it may be located in different places.

Set the lines for local access as "trust" for now (you can change it later), 

for TCP/IP access set the value as "md5".

To set TCP/IP access from any host, use "0.0.0.0/0" for IPv4, and "::/0" 

for IPv6.

 

3) Edit postgresql.conf file to allow TCP/IP access - uncomment and edit 

the "listen_addresses" option (see docs). On different systems, this file 

may be located in different places.

 

4) Restart your system or restart the postgresql server, for example:

 

  $ sudo /etc/init.d/postgresql stop

  $ sudo /etc/init.d/postgresql start

 

5) Check /etc/passwd file to find out which user account is used for the 

PostgreSQL admin access on your system (it may be "pgsql", or "postgres", 

or "postgresql"). Let's assume that this is "postgres" account.

 

6) Create a database for the TURN purposes, with name, say, "turn":

 

   $ createdb -U postgres turn

 

7) Create a user for the TURN with name, say, "turn":

   $ psql -U postgres turn

     turn=# create user turn with password 'turn';

     turn=# 

     Ctrl-D

 

8) Create the TURN users database schema.

$ cat turndb/schema.sql | psql -U turn turn

        NOTICE:  CREATE TABLE / PRIMARY KEY will create implicit index "turnusers_lt_pkey" for table "turnusers_lt"

        CREATE TABLE

        NOTICE:  CREATE TABLE / PRIMARY KEY will create implicit index "turnusers_st_pkey" for table "turnusers_st"

        CREATE TABLE

        CREATE TABLE

$ 

  Shared secret for the TURN REST API:

  $ bin/turnadmin -s logen -e "host=localhost dbname=coturn user=turn password=turn"

  $ bin/turnadmin -A -e "host=localhost dbname=coturn user=turn password=turn" -u gorst -r north.gov -p hero

  $ bin/turnadmin -A -e "host=localhost dbname=coturn user=turn password=turn" -u ninefingers -r north.gov -p youhavetoberealistic 

XV. MySQL (MariaDB) setup

The general setup idea is the same as for PostgreSQL case:

  Shared secret for the TURN REST API:

  $ bin/turnadmin -s logen -M "host=localhost dbname=coturn user=turn password=turn"

  $ bin/turnadmin -A -M "host=localhost dbname=coturn user=turn password=turn" -u gorst -r north.gov -p hero

  $ bin/turnadmin -A -M "host=localhost dbname=coturn user=turn password=turn" -u ninefingers -r north.gov -p youhavetoberealistic 

XVI. MongoDB setup

XVII. Redis setup

turndb/testredisdbsetup.sh file. One special thing about TURN Redis security setup

is that you can store open passwords for long-term credentials in Redis.

You cannot set open passwords for long-term credentials in MySQL and PostgreSQL -

with those DBs, you have to use the keys only. With Redis, you have a choice - 

keys or open passwords.

  Shared secret for the TURN REST API:

  $ bin/turnadmin -s logen -N "host=localhost dbname=2 user=turn password=turn"

  $ bin/turnadmin -A -N "host=localhost dbname=2 user=turn password=turn" -u gorst -r north.gov -p hero

  $ bin/turnadmin -A -N "host=localhost dbname=2 user=turn password=turn" -u ninefingers -r north.gov -p youhavetoberealistic 

XVIII. Performance tuning

XIX. TURN Server setup

XX. Management interface