Connect Your GitHub Account

Before Phemeral can deploy code from your GitHub repositories, you need to connect your GitHub account and authorize the Phemeral GitHub App.

Step 1: Open User Settings

Navigate to User Settings in the Phemeral dashboard.

Step 2: Connect GitHub

In the GitHub section, click Connect. This redirects you to GitHub to authorize the Phemeral OAuth integration.

Sign in to GitHub (if not already signed in) and authorize the application. After authorizing, you will be prompted to install the Phemeral GitHub App on your GitHub account or organization. During installation, GitHub will ask you to choose which repositories the app can access. You can grant access to all repositories or select specific ones.

Step 3: Verify the Connection

After completing the GitHub authorization and app installation, return to User Settings. The GitHub section should show your account as connected.

What Happens Next

With your GitHub account connected, you can now:

• Connect a repository to a Phemeral project (from the project's Settings tab).
• Map branches to environments for automatic deployments.

Continue to Deploy Your First Project for a step-by-step walkthrough.

Disconnecting GitHub

To disconnect your GitHub account, visit User Settings and click Disconnect in the GitHub section. This revokes the connection. Any existing repository connections on your projects remain in place but will stop receiving new push events until a GitHub account is reconnected.