> For the complete documentation index, see [llms.txt](https://crushsuite.gitbook.io/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://crushsuite.gitbook.io/docs/compliance/getting-started/installation-and-first-login.md).

# 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.

***