Skip to main content

Artifact Storage

Keep test artifacts private while still making them easy to access from Testream and Jira.

Testream supports two private storage modes:

  • Testream-managed storage - the simplest option, with private storage handled by Testream.
  • Customer-owned bucket storage - connect your own bucket when your team needs to control where artifacts live.

Artifact Storage Page

Storage Options​

OptionBest forWhat you manage
Testream-managed storageTeams that want the quickest setupNothing beyond using Testream normally
Customer-owned bucket storageTeams that need to persist artifacts in their own infrastructureBucket connection, project attachment, and connection health

Testream-Managed Storage​

Testream-managed storage is the default private storage option. It works well when you want private artifact storage without maintaining your own bucket setup.

Use this option when your team wants the simplest path from test runs to private artifact access.

Project-Storage-Testream-Managed

Open Storage From Projects​

From the Projects page, use the Manage button in the Storage column to open a project’s storage settings.

This is the quickest way to review the active storage mode, attach a bucket connection, or switch a project back to managed storage.

Open-Storage-From-Projects

Set Up a Customer-Owned Bucket​

  1. Open Artifact Storage in Testream.
  2. Create a new bucket connection.
  3. Enter the bucket details and credentials.
  4. Test the connection.
  5. Attach the connection to a project.
  6. Optionally set a base prefix for that project.

New-Storage-Connection

Manage Project Storage​

On a project’s storage page, you can:

  • view the active storage mode
  • test the current connection
  • edit the base prefix
  • disable customer-owned storage for the project

Attach-New-Storage

What Happens When a Connection Is Deleted​

If a bucket connection is deleted, Testream stops using it for future access. Historical artifacts and reports stored in that connection may no longer be available.

If you only want to stop using the connection for a project, disable it from the project storage page instead of deleting it.

Choosing Between the Two​

Choose Testream-managed storage if you want the fastest, simplest setup.

Choose Customer-owned bucket storage if your team needs to connect its own bucket and manage that connection over time.

Next Steps​