User Tools

Site Tools


software:chipmunk:setup:first_run

This is an old revision of the document!


First-Time Configuration

Once you’ve completed the prerequisite setup steps and deployed the Chipmunk appliance from the Azure Marketplace, it’s time to configure the system for first use.

This page guides you through the initial configuration process after deployment.

Step 1: Prepare Before Deployment

Make sure you have the following details ready before deploying the appliance:

  • ✅ Azure Subscription
  • ✅ Resource Group
  • ✅ Virtual Network (VNet) and subnet
  • ✅ Hostname you will assign to the appliance (e.g. chipmunk.yourcompany.local)
  • ✅ Azure App Registration (Client ID, Secret, Tenant ID)
  • ✅ Azure Blob Storage SAS URL
  • ✅ TLS Certificate files (PEM format), or plan to generate a self-signed certificate

All of these values were configured or generated during the previous setup steps.

Step 2: Deploy from Azure Marketplace

1. Open the Azure Portal 2. Go to Create a Resource 3. Search for Chipmunk - Automated User Archiving 4. Click Create 5. Fill in:

  • Subscription, Resource Group
  • Appliance Name (e.g., chipmunk)
  • Region and VNet/Subnet

6. Complete and deploy the resource

Deployment typically takes 3–5 minutes.

Step 3: Access the Setup Wizard

Once the appliance has finished deploying, open your browser and go to: http://chipmunk.yourdomain:3000// → You’ll see the Chipmunk Setup Wizard ===== Step 4: Enter Configuration Details ===== The setup wizard will prompt you to enter: * Tenant ID (from Azure App Registration) * Client ID (Application ID) * Client Secret * Blob SAS URL (from Storage Setup) * Azure AI Endpoint and Key (optional, for document summarisation) * TLS Certificate (upload PEM files if not using self-signed) * DNS hostname for this appliance Double-check each value before submitting. ===== Step 5: Finish Setup & Restart ===== 1. Click Submit 2. Chipmunk will apply your configuration and restart the appliance 3. Wait 2 full minutes for the system to restart and apply TLS settings After restart, your browser will be redirected to: https://chipmunk.yourdomain//

You may need to accept a certificate warning if you chose the self-signed certificate option.

Step 6: Log In and Verify

Once redirected, you’ll land on the Chipmunk dashboard login page.

You can now:

  • Monitor backups
  • View archived users
  • Restore data as needed

Troubleshooting

If you are not redirected after 2 minutes:

  • Check if the appliance is reachable via DNS
  • Ensure your firewall allows ports 443 and 3000 internally

Need help? Visit Support or contact support@smikar.com

chipmunk setup first_run configuration wizard tls deployment marketplace

software/chipmunk/setup/first_run.1751334056.txt.gz · Last modified: 2025/07/01 11:40 by support@smikar.com