Chipmunk Setup - Four-Step Walkthrough

Setting up a fresh Chipmunk appliance is a four-step process. Each step has its own guide - work through them in order; later steps depend on values you generate in earlier ones.

If you've just deployed the appliance from the Azure Marketplace and aren't sure where to begin, start here.

The four setup steps

Step 1: App Registration & API Permissions

Create an App Registration in Microsoft Entra ID (formerly Azure Active Directory) and grant it the Microsoft Graph and Exchange permissions Chipmunk needs to read OneDrive, Exchange, and Teams data for the users you offboard. You'll come away with a Tenant ID, an Application (client) ID, and a client secret - keep these somewhere safe; you'll enter them in Step 4.

Step 2: Azure Storage Setup

Create an Azure Blob Storage account, a container, and generate a SAS URL with the right permissions. Chipmunk writes every archived OneDrive/Exchange/Teams payload into this container - it stays in your Azure subscription, under your tenant's control. You'll enter the SAS URL in Step 4.

Step 3: DNS & TLS Certificate Configuration

Pick an internal DNS hostname for the appliance (for example, chipmunk.yourcompany.local), create the A-record, and provide a TLS certificate in PEM format. Chipmunk's web dashboard runs over HTTPS - without a valid hostname and cert, browsers will warn or refuse to connect.

Step 4: First-Time Configuration

Walk through the configuration wizard the first time you open the appliance. This is where the values you collected in Steps 1–3 (Tenant ID, App ID, secret, SAS URL, hostname, cert) get entered. Once this is done, the appliance is operational.

What you'll need before you start

Have these ready before opening Step 1 - collecting them all upfront makes the four-step pass much smoother:

• Azure access with permission to create App Registrations in Entra ID, a Storage Account, and (optionally) a VNet for the appliance.
• An internal DNS zone you can add an A-record to, plus the static IP the appliance will run on.
• A TLS certificate in PEM format matching that hostname, or a plan to use the appliance's self-signed certificate during initial rollout.
• An Entra ID security group for Chipmunk admins (e.g. chipmunkadmins) - only members can sign into the dashboard.

If anything's missing, work through the relevant step's guide - each one calls out exactly what to create.

Next steps

• Begin with Step 1: App Registration & API Permissions.
• After setup is complete, see the Chipmunk User Guides for day-to-day operation.
• Need help? Contact support.