Account Setup

Create your ButterStack account and set up your first project

Table of contents

1. Creating Your Account
   1. 1. Sign Up
   2. 2. Choose a Plan and Add a Card
   3. 3. Verify Your Email
2. Creating Your First Project
   1. Onboarding Wizard
      1. Step 1: Create Your First Project
      2. Step 2: Task Management Setup
      3. Step 3: Connect Source Control
      4. Step 4: CI/CD Pipeline Setup
3. Account Settings
   1. Profile Management
   2. Billing & Credits
4. Team Collaboration
   1. Inviting Team Members
   2. Permission Levels
5. Security Best Practices
   1. Two-Factor Authentication
   2. API Key Management
6. Troubleshooting
   1. Common Issues
7. Next Steps

Creating Your Account

1. Sign Up

Visit ButterStack.com and click Sign Up.

You can sign up using:

• Email & Password - Traditional account creation
• Google - Single sign-on with your Google account

On the signup form you provide your company name, your name, email, password, and acceptance of the terms.

2. Choose a Plan and Add a Card

ButterStack collects a payment card before your trial begins. You are not charged during the trial. See Billing & Credits below for the tiers.

3. Verify Your Email

Check your email for a verification link and click to activate your account.

Creating Your First Project

Onboarding Wizard

After the card step, ButterStack drops you into a four-step onboarding wizard. Each step is 25% of your onboarding progress, and you can leave and resume from /onboarding at any time.

Step 1: Create Your First Project

• Project Name - Your game or project title
• Project Type - Game or Web
• Game Engine - Unreal, Unity, or Custom (shown for Game projects only)
• Description - Optional

Step 2: Task Management Setup

• Use ButterStack Tasks - nothing to configure
• Connect Existing System - Jira. Trello, Monday.com, and Asana are marked Coming soon

Step 3: Connect Source Control

• Perforce Helix Core, GitHub, Lore, or Skip for now

Step 4: CI/CD Pipeline Setup

• Jenkins, GitHub Actions, or Skip for now. GitLab CI is marked Coming Soon

Account Settings

Profile Management

Access your account settings from the user menu:

• Profile Information - Update name, email, avatar
• Password & Security - Change password, enable 2FA
• Notifications - Configure email and in-app alerts
• API Keys - Generate keys for integrations

Billing & Credits

ButterStack uses a credit-based system for AI actions. There is no free tier: every plan starts with a 14-day free trial - no credit card required to get started.

Every AI action - a build fix, a failure analysis, an asset analysis - uses 100 credits. Each plan includes a monthly AI credit allowance, and your credits reset at the start of each billing cycle.

Team Collaboration

Inviting Team Members

1. Go to Project Settings → Team
2. Click Invite Member
3. Enter email address and select role:
   • Admin - Full account access
   • Member - Standard access to the projects they belong to
   • Reviewer - Focused on the asset approval workflow

Permission Levels

The account owner is always an admin and cannot have that role removed. Project-level access is separate from account role: a user sees a project’s builds and assets only if they are a member of that project.

Security Best Practices

Two-Factor Authentication

Enable 2FA for enhanced security:

1. Go to Account Settings → Security
2. Click Enable Two-Factor Authentication
3. Scan QR code with authenticator app
4. Enter verification code to confirm

API Key Management

When generating API keys:

• Use descriptive names (e.g., “Jenkins Integration”)
• Set appropriate permissions
• Rotate keys regularly
• Never commit keys to version control

Troubleshooting

Common Issues

Email Verification Not Received

• Check spam/junk folder
• Ensure email address is correct
• Request new verification email

Login Problems

• Clear browser cache and cookies
• Try incognito/private browsing mode
• Reset password if needed

Team Invitation Issues

• Verify email address spelling
• Check if user already has ButterStack account
• Ensure you have admin permissions

Next Steps

Once your account is set up:

1. Run the Quick Setup guide - Signup through first automated build in 15 minutes
2. Add Your First Integration - Connect your tools
3. Explore Integrations - Browse available tool connections

Need Help? Contact our support team at support@butterstack.com or join our Discord community.