Skip to content
Products
Platform
Developer Tools
Portal

Create organizations and spaces

In this topic we want to take a look at how to create organizations and spaces. Organizations (in short: orgs) are the top level virtual elements of the Cloud Foundry organizational model. They hold multiple spaces, which are areas in which you can host your applications. You can create orgs and spaces via the STACKIT Portal.

Check out our internal documentation to learn more about the general concept of organisations, spaces and user-roles.

Instructions

Section titled “Instructions”

  1. Open your project in the STACKIT Portal.

    … and select the project, in which you want to create your Cloud Foundry organization.

  2. Navigate to the Cloud Foundry tab in the sidebar.

    Here you can see the navigation element you need to press to get to the Portals Cloud Foundry Overview, where you can create and manage Organizations:

    Selecting the Cloud Foundry tab in the navigation.

  3. Press Create organization in the Cloud Foundry overview.

    Here you can see the two buttons you can trigger to open the organization creation screen in the Portals Cloud Foundry Overview, when you do not yet have a organization in your project:

    STACKIT Cloud Platform Dashboard with Cloud Foundry Option. The left navigation pane shows various services like Dashboard, Databases (MariaDB, PostgreSQL Flex, Redis), and Artificial Intelligence. The main panel displays the "Shared Cloud Foundry" service with an explanatory text. There are two yellow "+ Create CF organization" buttons: one near the top of the main panel, pointed to by a red arrow, and another in the center, also pointed to by a red arrow. These buttons are the primary action to initiate a new Cloud Foundry organization.

    If you, or somebody else with the necessary permissions, has already created an organization in your project, this organization will replace the central Create organization button and the org will be listed there instead.

  4. Name your organization.

    After pressing the Create organization button, you will be directed to the org creation screen, where you first have to name the organization you are about to create.

    Here you can see the field where you can type in the name of your organization:

    The field where you can name your organization in the org creation screen of the portal.

    The organization name is an unique identifier on the platform that will later be used to target your space when working with the Cloud Foundry. You can select whatever name you like and the Portal will check if that name is already taken and throw an error if this is the case.

    Besides being unique you can name your organization any way you like. Since orgs are only virtual structures you can use them to also organize your cloud infrastructure according to your organizational structures.

  5. Select a quota limit for your organization.

    As a next step you have to set the organizations quota limits. These limits define the maximum amount of resources that is shared over all the applications in the organization. You will not constantly pay for the resources you select as the quota limit here, but only the resources you use. This is more like setting a budget you want to and can afford. It is the maximum for all applications within your quota.

    STACKIT Cloud Foundry Organization Overview Quota Edit Button. The page shows the "General information" and "Quota" for a Cloud Foundry organization. The "Quota" section displays the default limits (5 GB RAM, 5 service instances, 3 app instances) and current usage. A red arrow points to the "Edit" button located in the top-right corner of the "Quota" section, which is used to modify the resource allocation limits for the organization.

    Here you can see the overview of the quota selection in the org creation screen of the portal. Just click on whatever org limit best fits your needs to select the one you want to define for your organization.

    The org quota limit view in the org creation screen of the portal.

  6. Define the spaces for your organization.

    As a last step you have to define the spaces you want to have in your organization.

    STACKIT Cloud Foundry Spaces Management Screen. The main content area is titled "Spaces" and features an icon of four squares (a grid) with two highlighted in yellow. The description text explains that a space is a workspace for isolation, provisioning, managing, and scaling applications. The left navigation pane has "Spaces" selected, indicated by a red arrow pointing to the selected menu item. There is a "+ Create space" button above the content and another near the bottom of the content.

    Here you see the overview for the space management at the bottom of the org creation screen in the portal.

    You can also create new spaces by pressing the “Create space”.

    STACKIT Cloud Foundry Spaces Management Screen with Create Space Buttons highlighted. The screen shows the "Spaces" view. There are two instances of the yellow "+ Create space" button, and both are highlighted by a red arrow pointing to them. The first is in the top-center action bar, and the second is in the middle of the content area. This emphasizes the action needed to create a new workspace within the Cloud Foundry organization.

    You can remove an existing space by pressing the three dot-sign for the context menu on the right side of the spaces row, as seen in the picture below.

    STACKIT Cloud Foundry Spaces List and Context Menu. The screen displays the list of spaces, with a single space named "demo" currently listed. A message at the top indicates that space roles can be managed via the platform's console UI or the CF CLI. An ellipsis icon (...) next to the "demo" space name has been clicked, opening a context menu that shows the single option: "Delete". A red arrow points to the "Delete" option within the dropdown menu, indicating the action to remove the space.