Workspace Management

Overview

A workspace is the primary organizational unit in RunnerHub. It contains your apps, environment variables, signing credentials, and all associated jobs and artifacts.

Resource Hierarchy

RunnerHub organizes resources in a clear hierarchy:

User
└── Workspace
    ├── Apple Signing Credentials
    ├── Workspace Variables
    └── App
        ├── Build Configuration
        ├── Environment Variables
        ├── Schedules
        └── Jobs & Artifacts

Each user can create multiple workspaces, and each workspace can contain multiple apps. This allows you to organize projects by team, client, or any logical grouping that works for your workflow.

Creating a Workspace

To create a new workspace:

1. Navigate to Dashboard → Workspaces
2. Click Create New Workspace
3. Enter a workspace name (e.g., “Mobile Team”, “Client A Projects”)
4. Click Create

Your workspace is now ready. You can immediately start adding apps and configuring build settings.

Workspace Features

Apple Code Signing

Each workspace can have one Apple signing configuration that applies to all apps within it. This centralized configuration includes:

• Apple ID credentials (API key)
• Development & distribution certificates
• Provisioning profiles
• Team identifiers

Tip

Apps within the same workspace can share the same signing configuration, eliminating the need to upload certificates multiple times.

Workspace Variables

Define environment variables at the workspace level that are available to all apps within that workspace. These are useful for:

• Build settings shared across multiple projects
• API endpoints or base URLs
• Feature flags
• Shared credentials (with encryption)

Access workspace variables in your pipeline using standard environment variable syntax:

steps:
  - name: Build with shared config
    run: |
      echo $SHARED_API_KEY
      echo $BUILD_ENVIRONMENT

Resource Limits by Plan

The number of workspaces available depends on your subscription:

Plan	Workspaces
Free	1
Pay-As-You-Go	3
Pro	Unlimited
Business	Unlimited

Managing Workspaces

Rename a Workspace

1. Open the workspace
2. Navigate to Settings → General
3. Click the edit icon next to the workspace name
4. Enter the new name and save

Delete a Workspace

Caution

Deleting a workspace is permanent. All apps, build history, and configuration will be removed. This cannot be undone.

1. Open the workspace
2. Navigate to Settings → General
3. Scroll to the danger zone
4. Click Delete Workspace
5. Confirm the deletion by typing the workspace name

Soft Deletion & Data Retention

RunnerHub performs soft deletion of workspaces, meaning your data is retained for a GDPR-compliant period (typically 30 days) before permanent removal. This allows for account recovery if needed.

During the retention period, deleted workspace data is:

• Not displayed in your dashboard
• Not included in usage calculations
• Accessible to RunnerHub support if you need to recover it

After the retention period, all data is permanently deleted from our systems.

Workspace Settings

Access workspace settings at Dashboard → [Workspace Name] → Settings.

General Settings

• Workspace name
• Workspace ID (for API usage)
• Created date
• Member count (if using Teams)

Billing

• Current subscription plan
• Usage and overage charges
• Billing contact

Security

• Active sessions
• Connected OAuth providers
• API tokens

Best Practices

Tip

Organize workspaces by logical boundaries: one workspace per team, client, or major product. This makes permission management and billing tracking much clearer.

• One workspace per team/client: Simplifies permissions and billing allocation
• Use consistent naming: Include the team or project name in workspace titles
• Set up workspace variables early: Reduce duplication by centralizing shared settings
• Review billing monthly: Monitor usage trends to anticipate plan upgrades
• Archive unused workspaces: Delete workspaces for completed projects to keep your dashboard clean