Getting Started

Get started with Timber quickly and easily

Timber is designed to be intuitive. When you first log in, Timber will guide you through setting up your account; a guide is not necessary. For those that prefer explicit instructions please follow the steps below.

1. Create A Personal Account

Navigate to the Timber app and create your personal account. You can signup through a social integration, such as Github or Google, or create a Timber specific account.

This should be your personal account, you do not need to create organization specific accounts unless you prefer. Timber offers the ability to create multiple organizations and switch between them all within the same account.

2. Create An Organization

Before you can use Timber you must create an organization. An organization is the highest organizational unit within Timber. It is a workspace that contains members, log sources, and more. Your chosen organization name will also serve as your URL slug (

3. Create A Source

After creating an organization you'll want to create your first log source. A source is simply a container for log data, such as a Kubernetes cluster, a Ruby app, or a collection of log files. You can create as many as you want and they should align with how you collect your log data.

4. Integrate Your Source

After creating your source Timber will display a set of credentials (your API key and source ID). Use these credentials to integrate your source with Timber.

4. Verify Log Delivery

Once you've integrated your source with Timber you'll want to verify log delivery using the source debugger. This will simply display the received log data. If you aren't seeing log data please read the troubleshoot log delivery guide.

5. Use Your Log Data

All done! Time to start using your log data: