Get started
Login
© 2024

Preset apps

Preset apps are available for all plans.

Preset apps build on app connectors. They let you select a preconfigured app from a Tailscale app catalog for your Tailscale network (known as a tailnet). For example, you can choose GitHub or Stripe as a preset app. Your tailnet reflects the app's domain and route information automatically.

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.
  • Creates an association of one or more tags for the app connectors used with the app.
  • Creates a command-line interface (CLI) command that starts app connectors with pre-approved route advertisements for the tag.

Preset apps periodically fetch domains and routes from the app's authoritative configuration and propagate any changes to the tailnet. These changes are logged as Configuration audit logs entries.

Some apps don't support pre-configuration and aren't 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 admin console displays the list of URLs that Tailscale uses to keep the preset app’s configuration up to date.
    3. For Connectors, select Select tags and select one or more 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 ellipsis icon menu and select Remove.
  3. Select Delete app.

List of preset apps

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

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

Tailscale automatically updates the presetAppID when you use the Apps page of the admin console to create a preset app. You can also manually modify the presetAppID for an app in your tailnet policy file.

Preset app namepresetAppID value
Confluenceconfluence
GitHubgithub
Google Workspacegoogle-workspace
Jirajira
Oktaokta
Salesforcesalesforce
Stripestripe

Last updated Nov 27, 2024