RealChat Software Version 1.7

Server configuration


To modify the server configuration stop the server ( if running ), edit the configuration files and start the server again.

Sample 'RealChatServer.conf' file here.

RealChatServer.conf Directives


ServerName Directive

Syntax: ServerName name
Default: ServerName RealChatServer

The name of the server


ServerPort Directive

Syntax: ServerPort number
Default: ServerPort 8080

The port the server listens to. 8080 is the standard web-cache port. It's good to use it if there's no web-cache or other service running on same machine, because many proxy/firewalling software blocks all traffic other than standard services. You may choose any other port i.e. 6667 is the standard IRC port. If you modify it, you *must* also change the PORT parameter in the applet invocation page.


HelloMessage Directive

Syntax: HelloMessage message
Default: HelloMessage Welcome to my RealChat server!

This is sent to clients when they log in.


ConsoleLog Directive

Syntax: ConsoleLog on/off
Default: ConsoleLog on

When set to on all activity ( messages, people enterning and leaving, etc. ) is printed out on the console. On UNIX machines it's useful to redirect the server's output to a separate tty so you can monitor it. See readme.txt for details.


FileLog Directive

Syntax: FileLog on/off
Default: FileLog off

File logging ( log files grow big, so default is off )


AbuseLog Directive

Syntax: AbuseLog on/off
Default: AbuseLog on

Logs suspicious actions ( BaseURL mismatches, telnet connections etc. )


BaseURL Directive

Syntax: BaseURL URL
Default: #BaseURL http://yoursite.com/chat/login.html

When set the server accepts connections only from users loading the applet from the specified URL. It is commented by default but it is STRONGLY recommended for security purposes to be set according to your applet URL.


EmotionsFile Directive

Syntax: EmotionsFile file
Default: EmotionsFile RealChatEmotions.conf

Predefined emotions file to load at startup. The EmotionsFile file must exists in the server folder. Every action is described in 3 sequental rows this way:

( NICK is replaced with the other user's name )


DropTimeout Directive

Syntax: DropTimeout timeout
Default: DropTimeout 100

Seconds to keep a client alive. When there's no activity on the client's socket ( client was dropped ) for period longer than timeout the client is killed. You might need to set a higher value here if most of your chatters are on a slower connection.


BanTimeout Directive

Syntax: BanTimeout timeout
Default: BanTimeout 100

Minutes to keep a banned address disabled.


FloodCheck Directive

Syntax: FloodCheck on/off
Default: FloodCheck on

Detects and kicks out users flooding the chat.


AdministratorPassword, OperatorPassword

Syntax: AdministratorPassword password
Syntax: OperatorPassword password
Default: #AdministratorPassword 1029
Default: #OperatorPassword 3847

Passwords are entered in the client applet chat area this way: __PASS:1029 [enter] - client gains administrator's permissions. Uncomment the lines and set the passwords to enable the administrative manager functions.


RoomName, RoomTopic, RoomPassword

Syntax: RoomName name
Syntax: RoomTopic topic
Syntax: RoomPassword password ( optional )

Initial room list the server starts with. Example:

RoomName Main
RoomTopic This is the main room

RoomName Kids room
RoomTopic Kids only please

RoomName Private party
RoomTopic this is a password protected room
RoomPassword blabla

RoomName ...
RoomTopic ...
Note the newlines after each room's description. You can set as many rooms as you wish. In the evaluation version the server is limited to one room only.


BadRoom Directive

Syntax: BadRoom name
Default: BadRoom Main

The room where misbehaved users are sent by private room owner's kick. name must be a valid room name for the server.


Next: Client configuratoin

Home