Skip to content

Creating a Profile

A profile is the core deployment unit in ntkDeploy. This tutorial covers the current authoring flow for desktop, mobile, and both-platform profiles.

Prerequisites

  • ntkDeploy is installed and opens successfully.
  • You have at least one environment name available.
  • You understand the basics of profiles and profile versions.

1. Open the Profiles Page

  1. In the left navigation, select Profiles.
  2. The page shows the profile list on the left and either preview or the editor on the right.

2. Start a New Profile

  1. Click Create Profile.
  2. Fill in the core metadata:
  3. Profile Name
  4. Environment
  5. Optional Department and Description
  6. Choose Target Platform:
  7. Desktop
  8. Mobile
  9. Both

The target platform determines which editor tabs are available.

3. Configure Desktop Sources

If the target includes desktop output, use Desktop Sources to define the Windows desktop artifact.

Typical desktop work in this tab includes:

  • adding sources,
  • assigning provider instances,
  • selecting buckets where needed,
  • setting file processing and sync rules.

ABAC attributes for desktop sources are configured on the Policy tab.

4. Configure Mobile Vaults

If the target includes mobile output, use Mobile Vaults to define the ntkMobile payload directly.

In this tab you can:

  • set mobileSettings.conductorAddress,
  • add or remove vaults,
  • choose each vault's provider,
  • assign provider instances via the built-in picker (connection details are resolved at build time),
  • toggle the Encryption setting for each vault,
  • configure vault settings.

Mobile vaults are independent profile data. They are not derived from desktop sources. ABAC attributes for mobile vaults are configured on the Policy tab.

5. Use the Policy Tab When Needed

The Policy tab is available for desktop, mobile, and both-platform profiles. It is where ABAC attributes are configured for desktop sources and mobile vaults when those target types are present.

  • Desktop-only profiles manage desktop source ABAC data.
  • Mobile-only profiles manage mobile vault ABAC data.
  • Both-platform profiles can switch between desktop sources and mobile vaults in the same policy workflow.

The Policy tab right pane shows a target-platform-aware JSON preview: mobile profiles see the mobile payload, desktop profiles see the appconfig preview, and both-platform profiles see both.

6. Validate and Save

  1. Click Validate if you want to run checks before saving.
  2. Resolve any validation errors.
  3. Click Save Profile or Save Changes.

After save:

  • a new immutable profile version is created,
  • desktop settings and mobile settings are persisted with the profile,
  • reopening edit mode reloads the saved target-specific state.

7. Edit, Clone, and Review History

  • Edit updates the profile and creates a new version.
  • Clone creates a new profile seeded from an existing one.
  • History lets you review and restore older versions.

Next Steps