Note: This document describes functionality only available if you have taken control over a Toolkit configuration. Please refer to the Shotgun Integrations Admin Guide, for details.
By default, SG Desktop stores the site configuration locally on the user's machine and uses this for all site-level actions. When you launch SG Desktop, Toolkit automatically checks for updates to Toolkit core and any engines and apps your site config uses (eg. the
tk-desktop engine). If updates are available, it will also download and install them automatically.
Alternately, you can configure Toolkit to have SG Desktop use a shared site configuration instead of using the local configuration. This will disable the auto-update function and you will now be responsible for updating your site config's installed core and apps and engines. You can do this just as you do with other pipeline configurations running the tank core and tank updates command within the site configuration.
Move your Site config
You can use the standard
tank command to move your site configuration to a shared location. Once you move the site config, you can manually manage it just like any other configuration. See the docs here for details on how to do that.
Update the Site config interpreter locations
Make sure that you have the path to a python interpreter defined for all platforms you use (by default, SG Desktop will only set the path to the interpreter for the platform you are on). Update
/shared/location/site/config/core/interpreter_*.cfg files to point to the respective platform's default SG Desktop install Python locations. These are usually:
Reverting back to the default behavior
Changed your mind? No problem.
Locate the PipelineConfiguration entity in Shotgun that is either not linked to any project or linked to the Template Project (if you started using Desktop before v1.2.1). The Template Project is a special Project in Shotgun that is hidden by default. The easiest way to find the entity is to create a global Pipeline Configurations page. You can do this by selecting "New Page" from the gear in the Pages menu and then creating a new Pipeline Configurations page that is not linked to any project.
Once you've located the pipeline configuration, clear the Mac Path, Windows Path, and Linux Path fields.
The next time the Shotgun Desktop is launched, the site configuration will be recreated and updates installed locally.