19 Installation Configuration and Search Paths

A configuration directory path is built into the Racket executable as selected at install time, and its location can be changed via the PLTCONFIGDIR directory or --config/-G command-line flag. Use find-config-dir to locate the configuration directory.

Modify the "config.rktd" file in the configuration directory to configure other directories as described below. Use the setup/dirs library (which combines information from the configuration files and other sources) to locate configured directories, instead of reading "config.rktd" directly. A "config.rktd" file can also appear in the directory (build-path (find-system-path 'addon-dir) "etc"), but it controls only the results of find-addon-tethered-console-bin-dir and find-addon-tethered-gui-bin-dir.

The path of the main collection directory is built into the Racket executable, and it can be changed via the --collects/-X flag, so it has no entry in "config.rktd". Most paths that are specified in "config.rktd" have default values that are relative to the main collection directory. The paths of the configuration directory and main collection directory thus work together to determine a Racket configuration.

A "config.rktd" file in the configuration directory should contain a readable hash table with any of the following symbolic keys, where a relative path is relative to the main collection directory: