# Installation & First Login

Get CrushSuite Compliance installed on your Shopify store and log in for the first time. This takes about 5 minutes.

{% hint style="info" %}
**You are here:** Phase 1 of 3 — Before You Start

Phase 1 covers installation and connecting to your compliance system. After this article and Connecting Your Vinoshipper Account (or Self-Compliance Setup), you'll move to Phase 2 — Configure.

See the full setup roadmap or skip ahead to the [Go-Live Checklist.](/docs/compliance/getting-started/go-live-checklist.md)
{% endhint %}

***

### Prerequisites

Before you begin, make sure you have:

* An **active Shopify store** (any plan — Shopify Plus is not required)
* A **Vinoshipper account** with API credentials, OR the intent to manage compliance yourself (see [Self-Compliance Setup](/docs/compliance/getting-started/self-compliance-setup-without-vinoshipper.md))

***

### Install CrushSuite Compliance

1. Open your **Shopify Admin** and navigate to **Apps** in the left sidebar.
2. Click **Search for apps** or go directly to the [Shopify App Store](https://apps.shopify.com).
3. Search for **"CrushSuite"** and select **CrushSuite Compliance** from the results.
4. Click **Install** and review the permissions CrushSuite needs to operate (product access, order access, checkout customization, theme modifications).
5. Click **Approve** to confirm the installation and accept the billing plan.

***

### First Login

After installation, CrushSuite opens automatically inside your Shopify Admin. You'll land on the **onboarding wizard** — a step-by-step setup flow that walks you through everything you need to configure before going live.

The onboarding wizard tracks your progress, so you can leave at any time and pick up exactly where you left off. Each step corresponds to a section in this Getting Started guide.

<figure><img src="/files/nreyogNHUHgwj4gdqnQs" alt=""><figcaption></figcaption></figure>

***

### What the Onboarding Covers

The wizard walks you through these steps:

1. **Connect your Vinoshipper account** — or choose self-compliance (Phase 1)
2. **Configure state shipping rules** — which states you can ship to (Phase 2)
3. **Set up state alcohol fees** — per-bottle fees by state (Phase 2)
4. **Configure your shipping profile** — activate real-time shipping rates (Phase 2)
5. **Set up Shopify sales tax** — tax collection for each selling state (Phase 2)
6. **Configure pre-checkout requirements** — age verification and address validation (Phase 2)
7. **Enable your app embeds** — compliance UI on your storefront (Phase 2)
8. **Test your store** — place a test order to verify everything works (Phase 3)

You don't have to complete everything in one session. The wizard saves your progress automatically.

***


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://crushsuite.gitbook.io/docs/compliance/getting-started/installation-and-first-login.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.