Installation Guide

Step-by-step guide to connecting your Linear workspace to Cloudback for automated backup of issues, projects, documents, and other workspace data.

Cloudback provides automated backups for your Linear workspace data, including issues, projects, documents, cycles, comments, labels, templates, and embedded files. This guide walks you through connecting your Linear workspace to Cloudback.

Overview of the Setup Process

To start backing up your Linear workspace with Cloudback, you'll need to complete the following steps:

1. Sign in to Cloudback with your existing Linear account

2. Add a Linear workspace via the Cloudback dashboard

3. Authorize Cloudback through Linear's OAuth flow

4. Verify configuration and optionally customize backup settings

Prerequisites

Before you begin, ensure you have:

• A Linear workspace — You must be an admin or owner of the Linear workspace you want to back up

• An active subscription — A Cloudback subscription plan that covers the workspace. You can purchase a plan via GitHub Marketplace, Azure Marketplace, or by contacting support for invoiced billing

Note: Unlike GitHub and Azure DevOps, Linear does not have a marketplace integration. Subscriptions are managed via existing payment methods and assigned to your Linear workspace through the Subscription Management page.

Step 1: Add a Linear Workspace

1. Sign in to the Cloudback Dashboard

2. In the left sidebar under Dashboard, click Add Account (the + icon)

3. Select Linear from the platform options

Step 2: Authorize Cloudback

Clicking "Linear" opens a popup window that guides you through two authorization steps. Both happen automatically in sequence — you only need to approve each one.

Step 3: Workspace Connection

After both authorizations complete, Cloudback will:

1. Retrieve your workspace information (name, URL, logo)

2. Verify that you have admin or owner access to the workspace

3. Create the workspace backup definition with default settings

You'll see a success confirmation, and your Linear workspace will appear in the dashboard under the Linear section in the left sidebar.

Step 4: Verify Configuration

After connecting your workspace, Cloudback applies the settings from your account. You can customize these settings by clicking on your workspace in the dashboard to open the Workspace Details page, then modifying the Settings section.

Assign a Subscription

If you haven't already, assign a subscription to your Linear workspace:

1. Navigate to Subscriptions in the left sidebar

2. Click View on the subscription you want to use

3. In the Account Assignments section, select your Linear workspace from the dropdown

4. Click Assign

Once connected and a subscription is assigned:

• Your first backup will run according to the configured schedule (or you can trigger one manually by clicking Backup now on the workspace details page)

• Each backup creates an encrypted ZIP archive containing all workspace data

• You can monitor backup status, download archives, or restore data from the dashboard

Setup Complete

Cloudback is now configured to protect your Linear workspace. Here's what to expect:

• Backup Schedule: Your first backup will commence according to the schedule you've set.

• Dashboard Access: Access your Cloudback Dashboard anytime at https://app.cloudback.it.

• Service Status: If you experience any issues, check our status page at https://status.cloudback.it/.

• Support: If you have any questions, don't hesitate to contact our support team.

Learn More

• Linear Backup Contents — What data is included in each backup

• First Backup Walkthrough — Step-by-step guide to your first backup

• Subscription Management — Assigning subscriptions to accounts

• Dashboard Overview — Navigating the Cloudback dashboard