> ## Documentation Index
> Fetch the complete documentation index at: https://namespace.so/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Accelerate Your GitHub Actions with Namespace

export const CenteredImage = ({src, alt, width, caption, className}) => {
  const [basePath, setBasePath] = useState("");
  useEffect(() => {
    const path = window.location.pathname;
    setBasePath(path === "/docs" || path.startsWith("/docs/") ? "/docs" : "");
  }, []);
  return <Frame caption={caption} className={className} style={{
    maxWidth: width,
    marginInline: "auto"
  }}>
			<OptimizedImage src={`${basePath}${src}`} alt={alt} />
		</Frame>;
};

Transform your CI/CD pipeline with high-performance runners.
Namespace offers unique capabilities for Linux, Windows and macOS to speed up your GitHub workflows.

## Getting Started

To speed up your workflows with Namespace, you need to connect Namespace with
your GitHub organization and do a one-line change to your workflow definition:

<Steps titleSize="h3">
  <Step title="Connect your GitHub organization to Namespace">
    [Open the Dashboard](https://cloud.namespace.so/workspace/ghrunners) to connect your GitHub organization.
  </Step>

  <Step title="Update your workflows">
    Change the `runs-on` field in a workflow file to a Namespace profile or label.

    ```yaml theme={null}
    jobs:
      build:
        runs-on: ubuntu-latest # [!code --]
        runs-on: namespace-profile-default # [!code ++]
        steps:
          - name: Checkout
            uses: actions/checkout@v4
          ...
    ```

    To read more about the available configuration options, including machine sizes, see [Configure your Runners](/docs/solutions/github-actions#configure-your-runners).
  </Step>

  <Step title="Done!">
    Your GitHub workflow will now run on Namespace!
  </Step>
</Steps>

## Configure your Runners

Namespace runners offer a high degree of customization and unique capabilities.
Start off by selecting your target OS / architecture and picking an optimal shape.
Subsequent guides will explore how to benefit from each of the available solutions.

<Steps titleSize="h3">
  <Step title="Create a Profile">
    1. Open the [Dashboard](https://cloud.namespace.so/workspace/actions/profiles) and press "New Profile".
    2. Specify a name. The name will be part of the `runs-on` label in your workflow file.
    3. Select if you want to run on Linux AMD64, Linux ARM64, Windows or macOS.
    4. Pick a resource shape. You can change the shape later to find the best fit.
           <CenteredImage width={600} alt="edit profile dialog" src="/docs/images/github-actions/runnerprofileapple.png" />
    5. Confirm by pressing "Create Profile".
  </Step>

  <Step title="Select the Profile">
    Update the `runs-on` label in your workflow file to select the runner profile:

    ```yaml theme={null}
    jobs:
      myjob:
        runs-on: namespace-profile-big-apple # [!code ++]
    ```
  </Step>
</Steps>

Namespace Runners are powered by Namespace Compute which uses best-in-class hardware for every platform:

* **Linux AMD64** runs on high-performance AMD EPYC CPUs.
* **Linux ARM64** supported by AmpereOne (high memory configurations), and Apple M4 Pro and M5 Max.
* **Windows AMD64** runs on high-performance AMD EPYC CPUs.
* **macOS ARM64** Apple M5 Max (or M4 Pro on some configurations).

Selecting an optimal resource shape can optimize your performance and cost.
Larger shapes may be faster if your workflows can make use of the additional resources.
Smaller shapes may be cheaper if your runner is oversized.
We recommend observing a few runs first before adjusting the resource shape.

## Next Steps: Optimize Your Workflows

Now that you have Namespace Runners configured, enhance your CI/CD pipeline with these advanced features:

**[Caching Solutions →](/docs/solutions/github-actions/caching)**
Learn how to implement cross-invocation caching for dependencies, tools, and build artifacts to dramatically reduce workflow execution time.

**[High-Performance Docker Builds →](/docs/solutions/github-actions/docker-builds)**
Discover how to leverage Remote Builders and local caching strategies for optimal Docker build performance.

**[Custom Base Images →](/docs/solutions/github-actions/custom-base-images)**
Speed up workflows by pre-installing your dependencies and tools in custom runner images.

**[Debugging Made Simple →](/docs/solutions/github-actions/debugging)**
Access advanced debugging tools and techniques that make troubleshooting GitHub Actions workflows effortless.

**[Optimizing Usage →](/docs/solutions/github-actions/optimizing-usage)**
Use the insights dashboard to monitor workflow performance, track resource usage, and identify opportunities to reduce costs and improve performance.

**[Advanced Configuration →](/docs/reference/github-actions/runner-configuration)**
Specific configuration options for privileged workflows, container jobs, advanced caching, and more.

## Enterprise Support

Need custom machine shapes, dedicated capacity, or specialized support?
Our [support team](mailto:support@namespace.so) can unlock runners with up to 512GB RAM and provide dedicated consultation for complex CI/CD requirements.