The configuration settings are stored in ferngate.ini. This is a text file
that you can edit with any standard text editor.
Lines starting with a # symbol are comments.
|
Setting |
Default |
Example |
Explanation |
| allow_net_create | allow_net_create false | allow_net_create true | When a user connects to Ferngate from the internet with Fern, FernWeb or Fernphone they must enter a password which which is checked against their pop password. For new accounts their is no user settings to check against. If this is a new account any password is acceptable if allow_net_create is true. If allow_net_create is false then the account and password must already exist - this means either it has been created by the sysadmin with the command 'tellfern add phonenumber pass=password' or their first connection is from a real phone and they send a command 'user username password [pophost]' |
| chat_new_tries | 1000 | chat_new_tries 10 | When processing a ‘chat new’ command, Ferngate will randomly select another user, if this person is blocking you or does not have chat enabled it will try another random user. This setting determines how many times it will pick a random user before giving up. |
| chat_non_fg | false | chat_non_fg true | if true let people chat to non ferngate users |
| country_code | none | country_code 64 | this prefix is added to phone numbers without a leading + |
| dbabble_server | host | dbabble_server our.dbabble.com | When a user sends a DBabble instant message it is sent as email to dbabble_user@dbabble_server |
| debug | false | debug true | Controls the amount of information recorded in ferngate.log |
| ferngate_msisdn | none | 6421463633 | phone number Ferngate will receive commands |
| fernphone_port | 9001 | fernphone_port 1234 | Ferngate will accept connections from the fernphone phone simulator on this port. |
| host | hostname | cant be set from config file. | Is automatically set to the tcp hostname of computer Ferngate is running on. This then provides a default setting for dbabble_server, smtp_server etc. |
| invalid_user_msg | none | invalid_user_msg Sorry you are not a valid Ferngate user | Normally if Ferngate recieves an sms message from a number which does not match its valid_user ini setting it just ignores the message, however if you add a message here it will send this to invalid users. It could tell them where to go to register for the Ferngate service. |
| logarea | workarea | logarea /var/spool/ferngate/logs | Directory for ferngate log file ferngate.log |
| lowercase_pass | true | lowercase_user false | If true then passwords are changed to lowercase before being used. Note some phones only allow uppercase characters to be sent. |
| lowercase_user | true | lowercase_user false | If true then usernames are changed to lowercase before being used. |
| manager_ip | 127.0.0.1 | manager_ip 1.2.3.4,161.23.45.* | Only allow manager connections from this wildcard list of ip address |
| manager_password | manager_password verysecret | The password for manager logins. | |
| max_daily_sms | 100 | max_daily_sms 10000 | Ferngate will not send more than this many sms message each day. Check sent with manager command + status |
|
pop_host |
smtp_server | pop_host our.pop.host | When a user sends a 'user username password [pophost]' command the pophost defaults to current stored pophost for that user or pop_host setting if its a new registration. |
|
reply_sms_server |
hostname | reply_sms_server my.smtp.server | When a user sends a dbabble instant message the reply address is either set to ferngate_number@reply_sms_server for sms replies. You may want to set this to point at your main smtp server and have it forward messages to ferngate_*@domain to ferngate |
| recv_smtp_port | 1025 | recv_smtp_port 25 | The port used for incoming smtp connections. These may be emails to ferngate_number@domain which are passed on as sms msgs to Ferngate users. If longer than 160 chars full message is forwarded as email to users email account. If link to smsc is via smtp sms commands to ferngate can alsobe recieved on this port. |
| user_register | Contact ferngate@netwinsite.com to register | Contact TeleFred to register for Ferngate | The message fernweb and fernphone users will get if they try to use ferngate without having first used the user command to register from a real phone. |
| seq_events | false | seq_events true | If true put a sequence number on the start of each sms message generated by an event. |
| sms_limit | 100 | sms_limit 200 | When registering new users they can optionally specify a sms msg limit and period eg 10 per day. |
| sms_limit_period | month | sms_limit_period week | When registering new users they can optionally specify a sms msg limit and period eg 10 per day. |
| sms_prefix | FG: | Ferngate normally prefixes every sms text message it sends with this string so that users can easily recognize ferngate messages. | |
| sms_server | host | sms_server sms.outsite.com | Ferngate links to an smsc or a gsm modem to send and recieve sms text messages. The link is made via either smslink or gsmlink. It connects to these link servers via TCP/IP sms_server is the address of the smslink or gsmlink server. |
| sms_smtp | false | sms_smtp true | If true then Ferngate will link to the smsc using smtp protocol rather than an smsclink(smpp) or gsmlink |
| sms_smtp_domain | sms.smtp.domain | sms_smtp_domain your.smsc.smtp.domain | Domain to use for sms sends. When Ferngate is sending sms messages to smsc using smtp it will send to this domain. |
| sms_smtp_ip | * | sms_smtp_ip | Only accept sms_smtp connections from these ip address. |
| sms_smtp_prefix | 011+1 | sms_smtp_prefix 012+ | If we get email on our smtp port and from domain = sms_smtp_domain and to address has this prefix then we remove it and process email as a ferngate command. ie we assume smsc is sending us sms message as email |
| sms_port | 9000 | Port 1234 | TCP/IP port used for connection to smslink or gsmlink for sending and receiving sms text messages |
| smtp_port | 25 | 1025 | Port to use when connecting to smtp_server to send emails. |
| sms_prefix | "FG: " | sms_prefix Ferngate response:
sms_prefix |
All sms messages sent by Ferngate will have this prefix added to them to alert recipient that the message is generated by Ferngate. Blank entry will produce no prefix. Default is "FG: " |
| smtp_server | host | smtp_server smtp.oursite.com | Internet address for smtp server Ferngate should use when sending email messages. |
| valid_sms_numbers | * | valid_sms_numbers +64*,+44* | Ferngate will only send sms text messages to matching numbers. For example to restrict to NZ and UK only you might use +64*,+44* wildcard list. |
| valid_users | * | valid_users +6421*,+64271234,+4425* | Ferngate only accepts commands from phone numbers mathching this wildcard list. Note numbers have been expanded to full format before comparison eg 021 463 633 will have become +6421463633 if country_code is 64 |
| viewarea | /ferngate/view | view_area /usr/fernview | Users can view the contents of .txt files in this area by using the command ‘view filename’ for example if there are files called weather.txt and specials.txt users can use the commands ‘view weather’ and ‘view specials’ |
| workarea | /ferngate | workarea /var/spool/ferngate | Workarea for ferngate user files. User information, cached messages etc are stored in hashed directories under this one. |