Skip to main content
Version: 0.10


Everything you can do in Wayfinder is related to a specific team and your permissions within it. There are three different ways to become a member of a team:

  • You're added by another team member.
  • You're sent an invite link.
  • You create a team, which you own/administer.

Teams have two default team roles, member and admin. Team administrators can create more team roles as needed to set role/access permissions for various Wayfinder resources. For information on what the default team roles can do, see Users and privileges.

Select a team#

Generally, a team owner/administrator creates a team and invites or adds other team members to it. But anyone can create a team to provision infrastructure for testing or other purposes.

You can select or specify a team either in the Wayfinder UI or CLI.

Select a team in the UI#

First login to the UI#

When you first log into the Wayfinder UI, click Get started.

You'll be guided to select a team that you already belong to, or create a new one. If you don't see the team you're looking for, you can ask a member of that team to add you or send you an invite link. If you're creating a new team, you'll also be guided to (optionally) create a cluster for that team at the same time.

When using the Wayfinder UI, once you select a team, it will be your default team until you select another team in the UI.

Switch to another team in the UI#

You may be part of more than one team in Wayfinder. The currently selected team is shown in the UI under the Teams tab on the left. For example, the release team is selected here:

Teams tab

To switch to another team, click Teams, and then select the team you want.

Specify a team in the CLI#

When using the CLI, you can:

  • Set a default team—see Setting a default team.
  • Specify another team in CLI commands without changing your default team, as shown below.

To specify a team other than your default team in the CLI:

  1. Use the -t flag to run a command for a team that is not your default team.

    For example, if your default team is release, you can apply the command below to the qa-team:

    kore create cluster qa -t qa-team

Add or invite team members#

Invite members#

You can use a team invite link from the Wayfinder UI for users who haven't logged into Wayfinder before. This link invites them to use Wayfinder and makes them a member of a specific team. You can also invite existing Wayfinder users to a team.

To invite members to a team:

  1. In the Wayfinder UI, navigate to the Members page, and then copy and share the invite link.

    The member you're inviting can use the link to automatically select that team upon login to the UI, and then the member's user ID is added to the Members page.

Add members to a team#

You can add existing Wayfinder users to a team.

To add members to a team:

  1. In the Wayfinder UI, navigate to Members > Add Kore users now.
  2. Start typing the member's user ID in the Add field, and select the user.
  3. If you're a team admin, you must also select a team role for this user.
  4. Click Add to team.

CLI: kore create member

Once you're in a team#

Here are some of the things you can do once you're in a team:

  • Configure a profile for your team to access an environment with the CLI—see kore profile configure.
  • Create a cluster and namespace—see Clusters and Namespaces.
  • Wayfinder creates domains for you automatically when you create a cluster, but if desired, you can create a custom cluster DNS zone for your app—see DNS .
  • Set up ingress and network policies for team apps—see Exposing your Applicatins via Ingress.
  • Create robots for builds or deployments with your CI system—see Robots.
  • View costs for your team's cloud infrastructure—see Costs.

Team administrators#

Team admins are owners of a team. They are team members with additional privileges. As a team admin, you can:

  • Promote team members to be team admins in the Wayfinder UI: Navigate to Members > Add user type.
  • Administer your team's role-based access (RBAC) by creating policies for how members can assume roles, or assign them to robots—see the RBAC section.
  • Create more team roles as needed, in addition to member and admin. You can then use these roles when defining RBAC policies—see kore create team-role.
  • Create an access policy allowing team members to have user access to a cloud account—see Create an access policy for your team.
Last updated on Sep 27, 2021