How to book shared test environments in Jira

By Jake Marsh · Updated

To book a shared test environment in Jira, install Berth, have a Jira admin add your environments, then open Apps > Environments and click Book on the environment's row. Pick when the booking starts and ends, say what it's for, and link a work item if you want. If someone already has it, Berth tells you who and until when, lists free environments of the same tier for the whole time, and says when yours is next free.

Set up the environments once

A Jira admin opens Jira settings > Apps > Berth > Environments > Add environment for each shared environment:

SettingExample
Name and keyQA 2, qa-2
Tiertesting
GroupShop
URLThe address testers open
OwnerThe person who looks after it
BookableYes (production isn't by default)
Longest booking8 hours

Under Settings, the admin picks the time zone for booking times, the first day of the week, who can book (everyone or one Jira group; Jira admins always can) and how far ahead.

Steps to book

  1. Open Apps > Environments. The board lists each environment's status, who has it, until when, and the version on it.
  2. Click Book on a row, or Book an environment to choose one.
  3. Pick the start, now or a date and time, and the end, within the environment's longest booking.
  4. Say what it's for, such as "Regression for 4.2", and pick a work item if the booking is for one.
  5. Save. The board shows the environment as booked from the start time.

When it's taken

Bookings can't overlap. Instead of an error, Berth gives you three things to act on:

  • Who has it and until when, so you can ask them directly.
  • Free environments of the same tier for the whole time you asked for.
  • When this one is free next.

Managing bookings

  • My bookings: change the end, end a booking now, or cancel one that hasn't started.
  • Week: every booking for the week across environments, with yours highlighted.
  • Owners and Jira admins can end anyone's booking on their environment from the environment's Bookings tab. The activity log records who did it.
  • Maintenance or down: an owner or Jira admin sets the status with a note. Down environments can't be booked.

Booking for a work item

When a booking names a work item, the work item's Environments (Berth) panel shows it, along with which version is on that environment. If your pipeline reports deployments to Berth, the panel also shows whether the work item is in that version. To set that up, see how to track deployments in Jira from any CI.

A board on the team dashboard

Add the Environment status (Berth) widget to a Jira dashboard and pick a group and tiers, for example the Shop group's testing and staging environments.

Berth starts with Atlassian's 30-day free trial; prices are on the Berth page.

What it costs

Berth is From $19 a month for up to 10 users. Every plan and the install link are on the Berth page.

Berth: Environment Booking and Deployment Tracking

Book shared test environments in Jira without clashes, and see which build and which work items are on each one, from any CI. From $19 a month for up to 10 users.


Questions

Can production environments be booked?

Not by default. A Jira admin can make any environment bookable or not.

Can I book an environment for next week?

Yes, as far ahead as the admin allows in Settings.

What if someone forgets to release an environment?

Every booking has an end, capped by the environment's longest booking (72 hours unless an admin changes it, at most 90 days). Owners and Jira admins can also end it early.

Can only some people book?

Yes. Booking can be open to everyone or to one Jira group, and Jira admins can always book.


More Berth guides


More Jira guides