Preset Apps

Preset Apps extends the benefit of App connectors by allowing you to select a preconfigured app from a Tailscale app catalog for use in your Tailscale network (known as a tailnet). For example, you can select GitHub or Stripe as a preset app. The app's domain and routes information is reflected in your tailnet automatically, so no additional tailnet configuration is required.

How it works

You choose a preset app from the Tailscale app catalog. This creates a workflow that:

• updates your tailnet policy file with the app's domain and routes information
• creates an association of one or more tags for the connectors used with this app
• creates a command-line interface (CLI) command that will initialize connectors with pre-approved route advertisements for the tag

Periodically, a preset app in use for a tailnet pulls domain and routes information from the app's authoritative configuration and propagates any changes to the tailnet. These changes are logged as Configuration audit logs entries.

Not all apps support pre-configuration, so those apps are not available in the Tailscale app catalog.

Add a preset app

You need to be an Owner, Admin, or Network admin of a tailnet to add a preset app.

If you do not already have one or more tags to associate with the preset app, define a tag.

To add a preset app:

1. Open the Apps page of the Tailscale admin console.
2. Select Add app.
3. In the Add an app dialog:
   1. For the Name field, provide a name for the app.
   2. For Target, select Select a target and select the preset app that you want to set up. After you select the app, the UI displays the list of URLs that Tailscale uses to keep the preset app’s configuration up to date.
   3. For Connectors, select Select ACL tags and select one or more ACL tags to use for the preset app.
   4. Select Save.

Remove a preset app

You need to be an Owner, Admin, or Network admin of a tailnet to remove a preset app.

To remove a preset app:

1. Open the Apps page of the Tailscale admin console.
2. For the preset app that you want to remove, select the menu and select Remove.
3. In the confirmation dialog, select Delete app.

List of preset apps

The following preset apps are available in the Tailscale app catalog:

• Confluence
• GitHub
• Google Workspace
• Jira
• Okta
• Salesforce
• Stripe

Audit logging of preset apps additions or deletions

Whenever a preset app is added or deleted, an Update policy for tailnet action is recorded in your tailnet's configuration audit logs.

Tailnet policy file details

The Apps page of the admin console is the primary way to set up a preset app. Alternatively, you can manually modify your tailnet policy file to set up a preset app. The following shows an example snippet that sets up GitHub as a preset app.

 "nodeAttrs": [
  {"target": ["*"], "app": {
    "tailscale.com/app-connectors": [
      {
        "name":        "github app",
        "connectors":  ["tag:code", "tag:ci-cd"],
        "presetAppID": "github",
      },

    ],
  }},
],

presetAppID values for preset apps

If you use the Apps page of the admin console to set up a preset app, each preset app's presetAppID value is automatically used in your tailnet policy file. The following information is provided for users that choose to manually modify their tailnet policy file to set up a preset app.