---
description: >-
  How to successfully set up a new Test Environment for an existing Knack
  application
---

# Copy an Application

* **Notify the Apps Team using the Slack channel `atd-knack.`**

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2FmRnebaFO7Axj3h0BPMxk%2F1_CopyApp.png?alt=media&#x26;token=352bcf99-10b5-4965-bf22-86915305e860" alt=""><figcaption></figcaption></figure>

* &#x20;**Log into Knack Builder using the Transportation Data Enterprise account (Knack Builder – Primary Account) using 1Password.**
* **Search for the application you want to copy.**

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2Ff6RhPRTlUx1rUaurBL80%2FSnag_19ca275.png?alt=media&#x26;token=5dd9e354-73a0-4c92-a2ef-9e553fcda327" alt=""><figcaption></figcaption></figure>

* **From the ... icon dropdown, select Duplicate App.**

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2FfUjuRMrQ7Mc2ojKkEcR3%2FSnag_19dd4db.png?alt=media&#x26;token=c4a7fc39-c144-46b5-93bc-4994f2521a6e" alt=""><figcaption></figcaption></figure>

* **Change the new app name and pause tasks (if applicable).**\
  Knack will automatically append Copy to the end of the name. Edit this out and use the format  PRODUCTION or TEST | DD MMM YYYY | \[APPLICATION NAME].

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2F6EgrGPcpkx5lJkq2DaZ4%2FSnag_19f5eb7.png?alt=media&#x26;token=3eb58e23-e6f8-44e9-9eb4-01fc422e6c82" alt=""><figcaption></figcaption></figure>

* **The new duplicate app will show up on the list  with a yellow dot next to the name**

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2F1GsAGiYqGQnlSVPQMFii%2FSnag_1a1fd3f.png?alt=media&#x26;token=e4ea4290-c0e9-4cdc-a9ae-cc336cc9a4eb" alt=""><figcaption></figcaption></figure>

* **Copying the app will take time.** \
  Knack will send an email to the Transportation Data Enterprise account when done.\
  You may want to let the service desk primary know that you’re expecting the email confirmation from Knack.

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2FriFNRnTqGI9BDBQtMvY5%2F7_CopyApp.png?alt=media&#x26;token=26520cbf-5cc3-4007-b898-ee41f78afe22" alt=""><figcaption></figcaption></figure>

* **After app has finished copying, add builders to the new duplicate app** \
  Select Manage Builders and add Apps team for builder access

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2F7zx05H1FFJP3OqvzVmsJ%2Fimage.png?alt=media&#x26;token=2942691d-46f4-4838-82b8-c127243bc819" alt="" width="563"><figcaption></figcaption></figure>

* **Add the new environment to the** [**DTS Portal listing of applications**](https://atd.knack.com/dts#applications)**.**  \
  Select the PRODUCTION environment you have copied and **Add Environment**. &#x20;

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2FloGhCDNOa8Eeh8Hb0Hvy%2F8_CopyApp.png?alt=media&#x26;token=711404a7-00b8-4544-81d9-0fa3bfe610b2" alt=""><figcaption></figcaption></figure>

* **Add the details about the new environment.**\
  To find the Application ID, go to the app > Settings > API and Code.

<figure><img src="https://3087753818-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-LzNSSXajDFpzOv2IhIv%2Fuploads%2FVSNgdII83NwBRplBY045%2F9_CopyApp.png?alt=media&#x26;token=104479e6-e63a-4eec-94a6-c81775e7d000" alt=""><figcaption></figcaption></figure>

* **IF APPLICABLE: Delete the old environment from Knack and add Date Deleted to the DTS Portal record.**
