Configuring Session Timeout

Prev Next

Curiosity uses the REFRESH_IDLE_TIMEOUT environment variable to control how long an authenticated session remains active before timing out due to inactivity.

This setting is configured on the api service within the Docker deployment.


Default Value

REFRESH_IDLE_TIMEOUT=3600

  • Value is in seconds

  • Default is 3600 seconds (1 hour)


Where It Is Configured

This variable is defined in the Docker configuration for the api service:

  • docker-compose.yml

  • or .env file (depending on deployment structure)


How to View the Current Value

Option 1 – Check docker-compose.yml

Locate the api service section and check:

environment:   - REFRESH_IDLE_TIMEOUT=3600

Option 2 – Inspect Running Container

On the Linux host:

docker exec -it <api-container-name> printenv | grep REFRESH_IDLE_TIMEOUT


How to Change the Timeout

  1. Edit the environment variable in:

    • docker-compose.yml

    • or .env file

  2. Set desired value (in seconds)

Example – 2 hours:

REFRESH_IDLE_TIMEOUT=7200

  1. Restart the API container:

docker-compose down docker-compose up -d

Or restart only the API container if preferred.