Where should the Spacelift admin stack be located?

Last updated: November 13, 2024

The location of your Spacelift admin stack depends on its intended functionality:

Admin Stacks in the Root Space

Admin stacks that need to manage, create, or delete spaces in Spacelift must be located in the "root" space. This is because only admin stacks in the root space have the necessary permissions to perform these space-related operations.

Admin Stacks in Child Spaces

If your space is inheriting from the root space, you can have admin stacks in child spaces. These admin stacks can perform the following actions within their respective child spaces:

  • Create stacks

  • Manage contexts

  • Set up cloud integrations

Choosing the Right Location

When deciding where to place your admin stack, consider the following:

  • If you need to manage spaces: Place the admin stack in the root space

  • If you're only managing resources within a specific space: You can place the admin stack in a child space that inherits from root

By placing your admin stacks in the appropriate location, you can ensure they have the necessary permissions to perform their intended functions while maintaining proper organizational structure within Spacelift.

To learn more about the best practices regarding spaces, see here!