How to Setup SaneCost

Get started in just 3 simple steps. The entire setup takes less than 5 minutes!

1

Add SaneCost to Slack

Click the "Add to Slack" button to install the SaneCost app to your workspace.

What happens during installation:

  • You'll be redirected to Slack's authorization page
  • Review the permissions SaneCost needs
  • Select which channel to post updates to (optional)
  • Click "Allow" to complete the installation
Add to Slack Now
2

Connect Your AWS Account

After adding to Slack, run the connect command to link your AWS account.

/sanecost connect aws

The command will provide:

  • • A CloudFormation template link customized for your workspace
  • • An API key that expires in 24 hours for secure setup
  • • Step-by-step AWS Console instructions

Note: Currently creates a basic EC2 read-only IAM role. In future releases, additional permission tiers will be available including RDS, EBS monitoring with cost data.

3

Deploy the CloudFormation Stack

Deploy our secure CloudFormation template to your AWS account.

In the AWS Console:

  1. a Click the CloudFormation link provided by the bot
  2. b Review the stack name (keep default or customize)
  3. c The API key is already embedded in the CloudFormation URL
  4. d Check "I acknowledge" box and click "Create Stack"
  5. e Wait ~2 minutes for stack creation to complete

Security: The stack only grants read permissions to EC2 and CloudWatch metrics. Stop permissions with resource tagging will be available in future releases.

You're All Set!

SaneCost will start monitoring your AWS infrastructure and notify you about idle instances within 30 minutes.

First scan will run automatically and notify you of any findings!

Useful Commands

/sanecost status

Show all connected AWS accounts and their status

/sanecost usage

View current usage, billing info, and resource limits

/sanecost config

View or update alert thresholds

Examples:

  • • /sanecost config cpu-threshold 10
  • • /sanecost config idle-hours 2
  • • /sanecost config channel #aws-alerts
/sanecost help

View all available commands and options

Need Help?

Common Issues:

CloudFormation stack fails to create

Ensure you have permissions to create IAM roles in your AWS account. You need administrator access or IAM creation permissions.

Not receiving notifications

Check that SaneCost has permission to send messages to your channels. Run /sanecost status to verify connection.

API key expired

The setup link expires after 24 hours for security. Run /sanecost connect aws again to get a fresh link.

Still need assistance?

Our support team is here to help!

Contact Support
Back to Home