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
   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 Token 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

Pick a plan on the pricing page before you sign up - the plan choice carries into signup. Your 14-day trial starts immediately, with no card collected. 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

Right after signup, 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 - Create and manage API tokens (Settings → API Tokens)

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, and no credit card is required to start it. You add a payment method when you convert, or when the trial ends.

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 Settings → Password
2. Click Enable under Two-factor authentication
3. Save the backup codes ButterStack shows you, then continue
4. Scan the QR code with an authenticator app and enter the verification code to confirm

API Token Management

When creating API tokens:

• Use descriptive names (e.g., “Jenkins Integration”)
• Grant only the scopes the token needs - a token starts with ping only
• Rotate tokens regularly and revoke unused ones
• Never commit tokens to version control

The full token value stays readable on the token’s page in ButterStack, so treat that page as sensitive. Every token creation emails its owner; see API Authentication.

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.