Rudeltippen

A football betting game based on the Play Framework and Twitter Bootstrap.

If you like Rudeltippen, Flattr it. Thanks!

Available tournaments

• 1. Bundesliga 2012/13
• Euro 2012

Features in a Nutshell

• Automatic results updates
• Automatic tournament management
• Automatic playing schedule updates
• JSON-API for 3rd party clients
• Fluid responsive layout
• Built-in themes from Bootswatch
• Smartphone and tablet compatible
• Gravatar support
• Twitter support
• SSL support
• Load balancer support
• Multilingual
• Runs on - Linux, Mac or Windows

Requirements

• Java SDK 1.6+
• Apache, Nginx, Lighttpd or any other HTTP-Server with Proxy-Support
• SMTP-Account (with SSL/non-SSL, e.g. Gmail)
• MySQL 5+

Available Languages

• German
• English

Screenshots

You can find some screenshots of Rudeltippen here

Installation guide

This installation guide assumes that you already have JDK 1.6+ installed and have your database- and SMTP credentials right beside you.

Step 0

Download and install Play Framework 1.2.x

Step 1

Download the latest tagged version of Rudeltippen and unzip to your INSTLLATIONFOLDER

Step 2

Rename INSTLLATIONFOLDER/conf/application.conf.example to application.conf

Open application.conf

Set your Rudeltippen URL

%prod.app.register.url=http://www.yourdomain.com

Set username and password for initial setup (make it "secure")

app.setup.username=admin
app.setup.password=admin

Set the language for Rudeltippen (currently de or en)

default.language=de

Rudeltippen has a feature which can automatically updates your playing schedule. By default this feature is not enable. If you want to enable this feature set 'automatic.updates' to true

%prod.automatic.updates=false

Set the application key for Rudeltippen (make it "secure")

application.secret=yoursecretcryptographicskey

Set you MySQL database connection.

%prod.db=mysql://user:pwd@host/database

Set your SMTP credentials (uncomment %prod.mail.smtp.channel if you want to use SSL)

%prod.mail.smtp.host=127.0.0.1
%prod.mail.smtp.user=admin
%prod.mail.smtp.pass=
#%prod.mail.smtp.channel=ssl

If you have a Gmail account, just enter your SMTP credentials as follows

%prod.mail.smtp.host=smtp.gmail.com
%prod.mail.smtp.user=yourGmailLogin
%prod.mail.smtp.pass=yourGmailPassword
%prod.mail.smtp.channel=ssl

Set your eMail-Sender and reply-to address

[email protected]
mailservice.from=Rudelmail <[email protected]>

By default, Rudeltippen runs with -Xmx=128m -Xmx64m. Change this, if required.

jvm.memory=-Xmx128m -Xms64m

Save application.conf

Step 3

Follow the section 'Front-end HTTP server' on the Play Framework Documentation to set up your Front-end HTTP Server with Rudeltippen.

By default Rudeltippen runs on Port 1904. If you need to change this, you'll find the port configuration in application.conf under 'Server configuration'.

Step 4

Start Rudeltippen by executing the following command in your INSTLLATIONFOLDER:

play start

Step 5

Open a Browser and go to http://www.yourdomain.com/system/setup

You did set username and password in application.conf (see Step 3)

Step 6

Change the default values if you want and create an initial user.

The initial user will be an administrative user and automatically activated. After the setup is complete, Rudeltippen will automatically load all data for the selected league.

Step 7

Login with your just created user and enjoy Rudeltippen!

If you need to stop Rudeltippen. Go to your INSTLLATIONFOLDER and execute the followin command

play stop

Upgrading

Step 1

Download the latest tagged version of Rudeltippen

Step 2

Go to your INSTLLATIONFOLDER and stop Rudeltippen by calling the following command

play stop

Step 3

Delete everything in INSTLLATIONFOLDER except the /conf folder and any custom script you may have created

Step 4

Unzip the latest version of Rudeltippen to your INSTLLATIONFOLDER and replace every every existing file.

Step 5

You are now ready to start Rudeltippen. If you are on UNIX or Mac you can just run the following command in your INSTLLATIONFOLDER

play start

Advanced configuration

SSL

By default Rudeltippen runs without SSL. If you want to enable SSL for Rudeltippen you need a private key and a certificate. In INSTLLATIONFOLDER/conf you find two empty files:

cert.txt.example
key.txt.example

Rename both files by removing .example

Paste you private key and your certificate in these files.

Open INSTLLATIONFOLDER/conf/application.conf and uncomment the following lines:

#https.port=9904
#%prod.certificate.key.file=conf/custom/key.txt
#%prod.certificate.file=conf/custom/cert.txt

You need to restart Rudeltippen in order for the changes to take place. After the restart Rudeltippen listens for SSL-Connection on Port 9904. You will need to change your HTTP-Front-End Server settings accordingly. Edit or update your Proxy settings to connect to the new port. Read the documentation of your HTTP-Server on how to configure SSL Proxy support.

Twitter

Rudeltippen can automatically post the following informations: daily top 3, results updated and new registration to a Twitter-Account. If you want to enable this feature you need a consumerkey, a consumersecret, a token and a secret. Open INSTLLATIONFOLDER/conf/application.conf, uncommend the following lines and paste your data:

#%prod.twitter.consumerkey=
#%prod.twitter.consumersecret=
#%prod.twitter.token=
#%prod.twitter.secret=
#%prod.twitter.enable=false

By default 'twitter.enable' is set to 'false'. Set it to 'true' to enable posting to the Twitter-Account.

You need to restart Rudeltippen in order for the changes to take place.

Log4j

If you want log4j Support for your Application you find an empty log4j configuration file in INSTLLATIONFOLDER/conf/custom. Edit this file with your required appenders and uncomment the following line in INSTLLATIONFOLDER/application.conf

#%prod.application.log.path=/log4j.prod.xml

You need to restart Rudeltippen in order for the changes to take place.

Load balancer

As mentioned in the Play documentation you can use a load balancer with multiple Rudeltippen applications. You need to set a different port for each Rudeltippen application and set these ports in your Front-End HTTP Server configuration. The jobs Rudeltippen executes do not know about how many instances you run and will by default run in each instance. To avoid this, you can set the name of the application- and the job-instance. Rudeltippen will only execute Jobs in an instance where the name of the appname and jobinstance matches.

application.name=rudeltippen
app.jobinstance=rudeltippen

You need to restart Rudeltippen in order for the changes to take place.

Support

If you need help, just visit the Support-Page and drop your question (English or German). If you found a bug or have a feature request, please open an issue on Github.

If you like Rudeltippen, Flattr it. Thanks!

Licence

Rudeltippen is distributed under Apache 2 licence