Workspaces

Workspaces let a team work in UpCloud together without sharing a login. Everyone logs in to the Control Panel with their own account, and you decide what each person can do, and where.

How Workspaces fits together

Workspaces has three building blocks:

• Organization: your company or team. It holds your workspaces and has its own members. When you sign up, you get an organization of your own, and you're its owner.
• Workspace: where your resources live. Each workspace has its own resources, billing, credits and quotas, so it works much like a separate UpCloud account. Every workspace belongs to one organization.
• Member: a person who logs in with their own account. One person can be a member of several organizations and workspaces, and switch between them in the Control Panel.

For example, a company that runs a web shop and a data platform, each with its own servers and its own budget, could set up Workspaces like this:

• One organization, named after the company, such as Example Company.
• Two workspaces in it, Web Shop and Data Platform. Each has its own servers, bill and credits.
• The two people who run the company's infrastructure are organization owners or admins, so they can manage both workspaces.
• The web developers are organization members with access to Web Shop only.
• A contractor who looks after the database servers has access to just those servers in Data Platform. They aren't a member of the organization.

How you split your resources into workspaces is up to you. Common ways are:

• By project or product, like Web Shop and Data Platform above, so that each one has its own budget and its own people.
• By environment, such as production and staging, so that people who work only on staging don't get access to production.
• By client, if you run infrastructure for other companies, so that each client's resources and billing stay separate.

Who can do what

What a person can do depends on two settings:

• Their organization role, Owner, Admin or Member, controls the organization itself: its members, its workspaces and its single sign-on.
• Their workspace access, Owner, Full access or Limited access, controls what they can do in one workspace. It's set separately in each workspace they're a member of.

Organization owners and admins automatically have Owner access to every workspace in the organization, unless they've been added to a workspace with a different access level (see Inherited access). Everyone else, including organization members, needs to be added to each workspace they work in. People from outside your organization, such as contractors, can be added to a workspace without joining the organization.

Roles and access covers each role and access level in full, and suggests which to give to whom.

What each workspace keeps to itself

Each workspace keeps these to itself, even when it belongs to the same organization as other workspaces:

• resources, such as Cloud Servers, storage devices and networks
• billing details, payment methods and credits
• resource quotas
• SSH keys, initialization scripts and API tokens

Billing and credits

Billing works per workspace:

• Each workspace needs its own payment information.
• Credits belong to one workspace. You can't use or move a workspace's credits in another workspace. A new workspace starts with a balance of zero, so add funds to it before you deploy resources there.
• The Control Panel shows the workspace you're in. The dashboard, the billing page and the billing log show the balance, usage and charges of your current workspace.

To add funds or set up automated payments, open the workspace's settings and select the Billing tab. The company name, address and VAT or GST registration number for invoices are on the Overview tab, under Billing details.

Current limitations

• You can't create more organizations. You own the organization created when you signed up, and you can be invited into other organizations. To remove an organization, contact support.
• You can't move resources from an older UpCloud account into a workspace yet. Keep them in their current account for now, and create new resources directly in a workspace.
• During the free trial, an organization can have one workspace. To create more, make your first payment in the workspace.
• Limited access members can see every private network in the list. They can only open and change the networks they've been given access to.

Next steps

• Get started with Workspaces: sign up, set up your organization and invite your team.
• Roles and access: what each organization role and workspace access level allows.
• Manage workspaces: switch between workspaces, create them, change their settings and delete them.
• Manage workspace members: add people to a workspace and change their access.
• Manage your organization: invite people to the organization and change their roles.
• Set up single sign-on: let members log in with their work accounts.
• API tokens in Workspaces: whose access a token has, and which tokens to delete when someone leaves.