How to set up a standalone server

Step 1
Download the Tesla Standalone Server, and unzip it to any directory. Note: The path must not contain any white spaces!
Step 2
Modify the server's firewall settings, such that it allows connections on ports 1199, 4561, 4562, 4563 and 4564. These are Tesla's default ports - you can modify the settings by modifying configuration/core/ on server side and Tesla's Connection Preferences on client side.
Step 3
If the server will accept connections from anywhere (depending on your firewall setup), you must change the default logins and their passwords, as you'd have a big security leak otherwise. Tesla uses JAAS for security, which is by default configured to use properties files with (unencrypted) usernames, passwords and roles. Modify the following files (additional documentation can be found there):

  • configuration/core/
  • configuration/core/tesla.user.roles
  • configuration/core/tesla.users

If you would like to change the authentication system (and use, for instance, LDAP instead of properties files), modify the JAAS login module defined in configuration/core/tesla.jaas.config (Note that this has not yet been tested - if you're experiencing any problems, please let us know).

Step 4
In case you prefer to use PostgreSQL instead of the default HSQL database, modify file configuration/core/ accordingly. An example configuration can be found in file configuration/core/
Step 5
Remove unwanted components from directory components, or add custom components at the same place. Also modify the data source configurations in directory configuration/datasources, as described in How to create a custom data source. If you do not need hot deployment, modify the property tesla.deployment.watcher.period in configuration/core/
Step 6
Launch the Tesla server from command line, by executing

  • java -Xmx1024M -jar tesla.server.jar

within the server directory. Note that the "-Xmx..."-option defines the amount of memory reserved for Tesla - you might want to further increase this value, depending on the components you would like to use.

Step 7
On client side, go to Tesla's connection preferences, and update the entries for user name, password and server url. If you changed the default ports used by Tesla, modify these values, too.