Skip to content
Machine Docs

Quick Start Guide

This guide will help you quickly set up and run your first GPU-accelerated GitHub Actions workflow using Machine.

Prerequisites

Before you begin, you’ll need:

  1. A GitHub account
  2. Admin access to a repository or organization on Github
  3. Access to the Machine Beta Program (join the waitlist at machine.dev if you haven’t already)

Step 1: Connect Your GitHub Account

Navigate to the beta program login page here: beta.app.machine.dev

Using the email address that you registered to the beta program with, you can access the platform dashboard by entering “Email Address” and clicking “Login with GitHub”.

Machine Beta Login Screen

You will be redirected to a Github Authorization page. You will be asked to authorize the Machine Beta app.

Machine Beta Authorization

This process will link your GitHub account to your Machine Beta account. You can only do this one time for each email address that is used to apply to the beta program.

You now have access to the Machine app.

Step 2: Install The Machine Provisioner GitHub App

Once logged in to the app you will see a banner letting you know that you need to make at least one Machine Provisioner Github App installation.

Machine App

Click on the “Add an Installation” button. You will be redirected to the Github App installation page.

Select Installation Location

Select the account or orgnanisation where you want to install the Machine Provisioner Github App. Then select the repositories that you want to enable Machine for.

Select Repositories

You can select the repositories that you want to enable Machine for. You can also select the “All repositories” option to enable Machine for all repositories in the account or organization.

Step 3: (Optional) Make another installation

You can add as many Machine Provisioner Github App installations as you need. From the Machine app, you can add another installation by clicking the “Add an Installation” button in the user installations dropdown menu.

Step 4: (Optional) Explore and create a Workflow from a Repository Template

You can create a repo from one of our public Repository Templates, and run a preconfigured workflow. Navigate to the explore page via the link the left navbar. On this page you can choose from a number of Repository Templates. These templates are preconfigured to run on Machine and can be used as a starting point for your own workflows.

Explore Page

Next Steps

Now that you’ve set up your first GPU-accelerated workflow: