Overview

This guide will explain how to configure a new organization through the admin portal. When you're finished, your devs will be able to start working in your first space.

A minimal setup consists of 4 layers:

• an organization, to manage your administrators;
• a deployment, to manage your servers;
• a collection, to manage your developers;
• a space, to manage a desktop environment.

Your organization was automatically created when you signed up for a Spaces pricing plan (see the previous guide), so this guide covers how to create your first deployment, collection, and space.

Note: If you would prefer an CLI-based or API-based setup process, see this reference doc for alternatives.

Creating a deployment

1. From your organization's page in the Spaces Admin Portal, click the NEW button above the (empty) list of deployments.
2. Enter your preferred display name and Google Cloud region.
   
3. Create your new deployment, which should appear in the deployment list.
   
4. You should receive a support email about your new deployment, which will update you on its status.

Optional: Granting fellow admins access to the organization

1. Click the NEW ADMINISTRATOR button above the list of administrators.
2. Enter the email address of one of your fellow admins.
3. Click the Save button.
4. Repeat steps #1-3 until all appropriate people have access to your new organization.

Creating a collection

1. When your deployment is ready, select it in the deployment selector at the top of the Spaces Admin Portal.
2. Click the + button at the top of the COLLECTIONS tab.
3. Create your new collection with your preferred name.

Granting access to the collection

1. Click the NEW USER button on the right side of the COLLECTIONS tab.
2. Enter your email address.
3. Optionally, choose to send a notification email.
4. Click the Save button.
5. Repeat steps #1-4 with your coworkers' email addresses until all appropriate people have access to your new collection.

Creating a space

1. Click the NEW SPACE button at the top of the COLLECTIONS tab.
2. Select any one of the images from itopia’s image catalog. For more information about itopia’s image catalog and how to create your own custom images, see this guide.
3. Optionally, customize the default settings for your new space.
4. Create your new space.

Optional: Testing your new space

1. Click the OPEN LAUNCHER PORTAL button at the top of the COLLECTIONS tab to visit your deployment's Spaces Launcher Portal.
2. Copy the URL of this webpage. You can send this URL to your coworkers, and anyone to whom you granted access in the previous section should see the same webpage that you see.
3. Click the LAUNCH button corresponding to your new space. After a delay, you should be inside your new space, with access to the desktop and installed applications.

Next steps

Now you have set up everything that your developers need to start working in your new space. To learn more about how to use and customize the container images that power your spaces, check out this guide on managing images.

If you have any questions or feedback, you can use the ? (Support & feedback) menu at the top-right of the Spaces Admin Portal to contact the Spaces support team.