> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fingerprint.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Deploy Fastly Compute Proxy Integration Manually

<Note>
  **Before you start: Read the general Fastly Compute guide**

  This document only covers deploying the Fingerprint Fastly Compute proxy integration using the Fastly web interface. It assumes you have already read the general [Fastly Compute guide](/docs/fastly-compute-proxy-integration) and completed the [step 1](/docs/fastly-compute-proxy-integration#step-1-create-a-fingerprint-proxy-secret).
  If you want to use Terraform instead of the Fastly web interface to install the integration, see [Deploy Fastly Compute using Terraform](/docs/deploy-fastly-compute-using-terraform).
</Note>

<Warning>
  **Limitations**

  This integration is exclusively supported for customers on the **Enterprise** Plan. Other customers are encouraged to use [Custom subdomain setup](/docs/custom-subdomain-setup) or [Cloudflare Proxy Integration](/docs/cloudflare-integration).
</Warning>

## Step 2.1: Create a Compute Service

Create a Compute service in your Fastly account.

1. Go to [Fastly Compute services](https://manage.fastly.com/compute).
2. Click **Create service** > **Create an empty service**.
3. On the top of the page, click **Options** > **Edit service name**.
4. Give it a readable name, for example, `fingerprint-fastly-compute-proxy-integration`, and click **Apply**.

## Step 2.2: Add a domain to the service

To get the proxy integration's accuracy benefits, we recommend using a subdomain of the website you want to use Fingerprint on, for example, `metrics.yourwebsite.com`.

To avoid ad blockers, do not use subdomains like `fingerprint`, `fpjs`, and other fingerprint-related terms.

1. Inside the service configuration left-hand menu, click **Domains** > **Add domain**.
2. Input your domain for the proxy integration, for example, `metrics.yourwebsite.com`.
3. Click **Create** to save changes.

<Note>
  **Safari accuracy on non-Fastly websites**

  For maximum accuracy, both your website and your proxy integration should be served by Fastly.

  You can use the Fastly Compute proxy integration even if your website is not served by Fastly, but this setup will likely limit Safari cookie lifetime to 7 days, resulting in lower accuracy. Because your website and the proxy integration will likely have different IP ranges, Safari will apply the same cookie lifetime cap as for third-party CNAME cloaking. This is still an improvement over third-party cookies getting blocked entirely by Safari.
</Note>

## Step 2.3: Configure the service backend in Fastly

Fingerprint API is available in three different [regions](/docs/regions): `api.fpjs.io` (Global), `eu.api.fpjs.io` (EU), and `ap.api.fpjs.io` (Asia). Use the right regional hostname depending on your Fingerprint workspace data region.

1. Go back to [Compute services](https://manage.fastly.com/compute) and open the configuration of your service.
2. Inside the service configuration left-hand menu, click **Origins**.
3. Under **Hosts**, type `fingerprint` and click **Add**.
4. Click **Edit** on the created host.
   * Keep the name as `fingerprint`. The proxy integration expects this exact name.
   * Set the **Address** and **Override host** to the regional Fingerprint API host for your workspace:
     * `api.fpjs.io` - Global (US)
     * `eu.api.fpjs.io` - EU
     * `ap.api.fpjs.io` - Asia
   * Click **Update** to save changes.

## Step 2.4: Add a secret store to the service

1. In Fastly, navigate to **Resources** > [**Secret stores**](https://manage.fastly.com/resources/secret-stores).
2. Click **Create store**.
3. Name the config store `Fingerprint_Compute_Secret_Store_<SERVICE_ID>`, where the suffix is your proxy integration's [Compute Service ID](https://docs.fastly.com/en/guides/about-services). Make sure you don't have any spaces in the Secret store name after copy-pasting your service ID.
4. Click **Create**.
5. In the **Linked Services** tab, click on **Link service** and select `fingerprint-fastly-compute-proxy-integration`.
6. Click **Next**, select the current (draft) version of your service, and click **Link only**.
7. Click **Finish**.
8. Click **Add item** and set `PROXY_SECRET` to the proxy secret value you generated in [Step 1](/docs/fastly-compute-proxy-integration#step-1-create-a-fingerprint-proxy-secret).

<Note>
  **Note: Proxy secret required**

  Proxied identification requests without a valid proxy secret will result in an authentication error and not receive identification results.
</Note>

## Step 2.5: Deploy the proxy package and activate your service

Deploy the proxy service code to your Fastly Compute Service.

1. Go to the [latest release](https://github.com/fingerprintjs/fastly-compute-proxy/releases/latest) in the Fastly Compute Proxy Integration GitHub Repository.
2. Download `fingerprint-fastly-compute-proxy-integration.tar.gz` to your computer.
3. Inside Fastly, navigate to **Compute** > [**Compute services**](https://manage.fastly.com/compute), open your proxy integration service, and switch to the **Service configuration** tab.
4. In the left-hand menu, click **Package**.
5. Click to **Browse For Package** and upload the `fingerprint-fastly-compute-proxy-integration.tar.gz` package.
6. Click **Activate** in the top right corner of the page (if you see **Validating** instead, wait for it to complete).

Wait a couple of minutes for the activation. You can go to `metrics.yourwebsite.com/status` to verify that your integration is running.

## Step 2.6: Issue a TLS certificate for your subdomain

1. Inside the Fastly Dashboard, navigate to **Domains** > **TLS Management** > [**Domains**](https://manage.fastly.com/network/domains).
2. Click **Secure domain** or **Secure another domain**.
3. Select **Use certificates Fastly obtains for you**.
4. Enter your domain (for example `metrics.yourwebsite.com`) and click **Add**.
5. Configure *Certification Authority* and *TLS configuration* according to your needs and click **Submit**.
6. Follow the instructions on the screen to [verify ownership of your domain](https://docs.fastly.com/en/guides/setting-up-tls-with-certificates-fastly-manages#verifying-domain-ownership). This usually involves creating a CNAME DNS record on your domain like `_acme-challenge.metrics.yourwebsite.com`.

Give Fastly some time to verify the DNS record. Once verified, Fastly will issue a certificate for your domain and display a green **Issued** status.

## Step 2.7: Point your subdomain to Fastly

Once your domain is verified and active, you need to [choose the right hostname for your DNS record](https://docs.fastly.com/en/guides/working-with-cname-records-and-your-dns-provider#choosing-the-right-fastly-hostname-value-for-your-cname-record).

1. Go to **Security** > **TLS Management** > [**Domains**](https://manage.fastly.com/network/domains).
2. Find your domain and under *TLS configuration and DNS details,* click **View/Edit**.
3. The **CNAME records** section contains the value for your CNAME record, for example, `t.sni.global.fastly.net`.
4. [Add a subdomain CNAME record](https://docs.fastly.com/en/guides/working-with-cname-records-and-your-dns-provider#setting-up-the-cname-record-with-your-dns-provider) to your domain's DNS and point it to the Fastly hostname from the previous step. For example:
   ```txt theme={"theme":"github-dark-dimmed"}
   metrics.yourwebsite.com.    3600    CNAME    t.sni.global.fastly.net.
   ```

## Step 3: Configure the client agent

Go back to the general Fastly Compute guide to [Configure the Fingerprint client agent to use your service](/docs/fastly-compute-proxy-integration#step-3-configure-the-fingerprint-client-agent-to-use-your-service).