Configuration

There are some configuration that may be changed to improve GrapeCall overall experience:

Warning

Unless Grape Call is available for you, changing the settings below will have absolutely no impact.

Warning

You must restart grape application in order to load new value.

Warning

Please, read the section GrapeCall Life-Cycle carefully before changing any value.

Enable GrapeCall for PMs (1:1 calls)

This settings controls whether Grape Call will be enabled for private conversations (1:1 calls).

default: enabled

To disable it, simply add GRAPE_CALL_PM_ENABLED=0 to your grape-extra.env.

Enable GrapeCall for groups

This settings controls whether Grape Call will be enabled for groups. Currently, this feature in under test and therefore is not enabled by default.

default: enabled

To disable it, simply add GRAPE_CALL_ROOM_ENABLED=0 to your grape-extra.env.

Define the ringing duration

This settings controls for how long receiver’s device (mobile or web) will ring before automatically canceling the call. A device rings when a 1:1 call is started or when you invite someone to a group call.

default: 30

You can change this value by setting GRAPE_CALL_RINGING_DURATION_SEC=30 on your grape-extra.env. Notice this values is in seconds.

Define the keep alive period

Check Keep Alive for more information about the keep alive.

Defines the period with which the keep alive RPC should be called to “refresh” the call. The value chosen here will influence on both GRAPE_CALL_MEMBER_LIFESPAN and GRAPE_CALL_LIFESPAN_SEC.

default: 10

If you decide to change this value, you need to set GRAPE_CALL_KEEP_ALIVE_PERIOD_SEC=<desired time in seconds> on your grape-extra.env.

Define GrapeCall lifespan

Check GrapeCall Lifespan for more information about GrapeCall lifespan.

default: 30

If you decide to change this value, you need to set GRAPE_CALL_LIFESPAN_SEC=<desired time in seconds> on your grape-extra.env. When doing so, you might want to change GRAPE_CALL_KEEP_ALIVE_PERIOD as well.

Define membership lifespan

Check Member Lifespan for more information about Member lifespan.

User will not be considered in call after GRAPE_CALL_MEMBER_LIFESPAN seconds this is used as a TTL for redis, which is refreshed after a keep alive is sent.

If you decide to change this value, you need to set GRAPE_CALL_MEMBER_LIFESPAN=<desired time in seconds> on your grape-extra.env. When doing so, you might want to change GRAPE_CALL_LIFESPAN_SEC as well.

Set the maximum number of users that can join a GrapeCall

It defines the maximum amount of users that can on a call at the same time. The proper value here will depend of your current Grape setup and hardware.

default: 100

You just need to set GRAPE_CALL_MAX_USERS_IN_CALL=<desired number> to change this value.

Set amount of days we should keep a GrapeCall stats

Amount of days we should keep a call stats. Stats are used to build the debug page.

default: 1 day

You just need to set GRAPE_CALL_STATS_TTL_SEC=<desired number of days> to change this value.

Clean up period

This will set the period (in seconds) of the clean up job.

default: 35

You just need to set GRAPE_CALL_CLEANER_SEC=<desired period> to change this value.

For more information about this process, please check Cleaner.