Skip to content
Bugtail Docs
Start free
Menu

Quickstart

From nothing to your first error in Bugtail, in about ten minutes.

1. Create an account

Sign up with your name, your work email address and a password.

If your company already uses Bugtail and allows colleagues to join with their work address, you land straight in its dashboard and can skip to step 3. Otherwise, ask a colleague for an invitation or continue below to create a new organisation.

2. Prove your company domain

An organisation in Bugtail is identified by its domain, such as example.com. Enter the domain of your work address and Bugtail shows a TXT record to add to it:

  1. Add the record in your DNS panel, at your registrar or wherever the domain is hosted.
  2. Click Check now. DNS changes usually show up within a few minutes, occasionally within an hour. You can close the page and come back.
  3. Once the record is found, name your organisation, optionally add a VAT number, and choose its language.

Addresses at public mailbox providers, such as Gmail or Outlook, cannot be used to create an organisation.

Your organisation now has its own dashboard at https://<organisation>.bugtail.eu, a first project and a collector that is ready to receive data. It starts with a 14-day trial of the Team plan. No card is needed, and when the trial ends the organisation moves to the Free plan by itself.

3. Connect your application

Open Get started in the sidebar. Pick your platform and follow the steps: the snippets there already contain your collector's key.

You can also follow the guide for your platform:

4. Send a test event

The last step of Get started waits for your first event and tells you when it arrives. From a Laravel application:

php artisan sentry:test

From any machine, with the key of your collector:

curl -X POST https://ingest.bugtail.eu/ingest/<key>/events \
  -H "Content-Type: application/json" \
  -d '{"message":"Bugtail test event","level":"error","environment":"production"}'

The event shows up under Issues within seconds.

5. Next steps