--- title: "DevLink" slug: "devlink" status: "update" updated: 2026-08-10T23:28:45Z published: 2026-08-10T23:29:24Z canonical: "docs.processmaker.com/devlink" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.processmaker.com/llms.txt > Use this file to discover all available pages before exploring further. # DevLink DevLink provides a streamlined way to manage, share, and synchronize assets across ProcessMaker instances, enabling administrators to maintain consistency and making the transition from development to production seamless. Key capabilities include: - **Consistent Configuration**: Use DevLink to ensure all linked instances share the same assets, reducing discrepancies and errors. - **Streamlined Deployment**: Bundle assets for easy deployment to multiple instances, ensuring consistency across different environments. This feature automates synchronization, reducing administrative effort of moving each individual asset and ensuring up-to-date asset management. Once linked, any changes in assets can be updated across all linked instances in minutes. Setting up DevLink involves two steps: - [**DevLink Configuration**](/v1/docs/devlink#set-up-a-devlink-environment): Link ProcessMaker instances to enable secure, automated asset sharing. - [**Bundle Creation and Management**](/v1/docs/bundle-management): Package assets into bundles and update linked instances when bundles are modified. Watch the following product tour to learn how to use DevLink for environment synchronization. [Embedded content](https://demos.processmaker.com/embed/cm8lbexb6008kxm0irnjd94n9?embed_v=2) --- ## DevLink Configuration **Permissions** Your user account or group membership must have the [**Make this user a Super Admin**](https://docs.processmaker.com/docs/permission-descriptions-for-users-and-groups#super-admin) permission selected. Only **Super Admins** are allowed to authorize DevLink connections. Follow these steps to link instances in your organization: 1. Ensure that you are [logged on](/v1/docs/participant-basics#log-on-to-processmaker-platform) to ProcessMaker Platform. 2. Access the **Admin** tab from the top menu, and then click the **DevLink** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/DevLink Icon.png) from the left sidebar. 3. Click the **Add Instance** button to add a new instance. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Create a New DevLink.png) 4. Enter the name and the target instance URL, then click **Create**. 5. You will be redirected to the target instance’s login page. Enter login credentials and sign in. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Login%202026.png) 6. After entering credentials, authorize the connection request from the target instance. **Note:** Only [**Super Admin**](https://docs.processmaker.com/docs/permission-descriptions-for-users-and-groups#super-admin) users can authorize DevLink connections. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/DevLink Authorization Request.png) 7. Once authorized, the instances will be linked, allowing secure sharing of assets and configurations. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Linked Instances.png) 8. Click the **Shared Assets** tab to enable sharing of assets on the remote instance, allowing the other instances to access and view them directly. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Shared Assets - DevLink.png) > [!NOTE] > Connection Troubleshooting > > - Verify that the URL entered for the target instance is correct and it is reachable. > - Confirm that the target instance has been upgraded to the latest ProcessMaker release > - Ensure that you are using [Super Admin](https://docs.processmaker.com/docs/permission-descriptions-for-users-and-groups#super-admin) credentials for both local and target instances. > - If the connection times out, contact [ProcessMaker Support](https://support.processmaker.com/hc/en-us) to adjust the [session timeout](/v1/docs/session-timeout-warning) setting for your instances. --- ## Bundle Creation and Management **Bundles** are packaged groups of assets such as processes, screens, scripts, data connectors, and settings, that can be shared and installed across different instances. Bundles streamline deployment, simplify version control, and ensure consistency, making it easy for administrators to manage assets across environments. Key capabilities include: - **Comprehensive Asset Management:** Include various assets, from processes and screens to data connectors and scripts, within a single bundle for easy deployment across instances. - **Efficient Version Control:** Track and manage different versions of assets, ensuring all linked instances maintain the latest updates and changes. - **Admin Control:** Administrators can create, lock, and update bundles as needed, granting full control over assets across instances. - **Seamless Environment Synchronization:** Enable standardization across environments by managing consistent assets across all linked instances. - **Asset Update Notifications::** Receive automatic notifications whenever asssets within a Bundle are updated. **Permissions** Your user account or group membership must have the [**Make this user a Super Admin**](https://docs.processmaker.com/docs/permission-descriptions-for-users-and-groups#super-admin) permission selected. Only **Super Admins** are allowed to manage Bundles. ### **Create a Bundle** Follow these steps to create a new bundle: 1. Access the **Admin** tab from the top menu, then click the **DevLink** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/DevLink Icon.png) from the left sidebar. 2. Click the **Local Bundles** tab, and then click the **Create Bundle** button to create a new Bundle. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/New Bundle.png) 3. Enter a name for the Bundle and click **Create**. The new bundle is added to the list of bundles. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Local Bundles.png) 4. Click the **Published** toggle key to make the bundle visible in any linked instances. 5. Disable access to the bundle at any time by disabling the **Published** toggle key. ### Add Assets to a Bundle The following assets can be added to a Bundle: - Processes - Scripts - Screens - Data Connectors - Decision Tables - Genies - Collections Follow these steps to add assets to a bundle: 1. Access the asset list you want to add. For example, view the [Process List](/v1/docs/view-edit-and-search-for-processes#view-active-and-inactive-processes) from the [Designer Home Screen](/v1/docs/designer-welcome-screen). ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Add to Bundle - Process List.png) 2. Click the options menu ![Task Dots](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/image-1740075285120.png) , then select **Add to Bundle**. 3. Select the required bundle from the list. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Add Asset to Bundle.png) 4. Click **Save**. The process is now added to the Bundle and can be accessed from linked instances. 5. Other assets (screens, scripts, collections, etc) can also be added to Bundles in a similar manner. > [!NOTE] > Bundle Guidelines for Assets > > - When a process is added to a bundle, the following assets in the process (if any) are also added to the bundle: > - Screens > - Scripts > - Data Connectors > - Collections > - Decision Tables > - FlowGenies > - When a process is downloaded from a bundle, all related assets, along with their configurations, are automatically imported to ensure seamless integration. --- ### Add Platform Configurations and Settings to a Bundle In additional to designer assets, certain platform configurations and settings can also be added to a Bundle. Follow these steps to add configurations and settings: 1. Click on the **Local** **Bundles** tab to view available Bundles. 2. Click on a Bundle to open it. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Opened Bundle.png) 3. From the **Platform Configurations** section, select one or more of the following configurations: 1. Users 2. Groups 3. Dashboards (**Custom Dynamic UI Dashboards** including their Display Screen dependencies and required relationship mappings) 4. Menus 5. Script Executors 6. Public Files ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Bundle - Platform Configurations.png) 4. From the **Settings** section, select one of more of the following settings: 1. Email Settings 2. Login and Auth 3. User Settings 4. Integrations 5. UI Settings ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Bundle - Settings.png) > [!NOTE] > Bundle Guidelines for settings and configurations > > - Individual user account or groups can be added to Bundles, using their respective ellipses menus from the User/Group lists. > - Individual system settings can be added to Bundles using their respective ellipses menus, from the Admin page. --- ### **Install a Complete Bundle** 1. Access the **Admin** tab from the top menu, then click the **DevLink** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/DevLink Icon.png) from the left sidebar. 2. Click a linked instance to view the available bundles in it. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Bundles in Linked Instances.png) 3. Choose the bundle you want to install in your instance, and then click the install icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Cloud Icon.png). ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Confirm Install Bundle.png) 4. If assets in the bundle already exist in the destination instance, the install icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Cloud Icon.png) will not be displayed. 5. Once installed, the bundle will appear in the **Local Bundles** tab. The **Origin** column indicates whether a bundle is local or synced from another instance. 6. Click the options menu to reinstall any of the bundles, if needed. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Install Bundle Updates.png) 7. Click **Open** to view the assets in the Bundle. 8. Click **Reinstall Bundle** to reinstall an already installed Bundle. 9. Click **Delete** to remove a Bundle from this instance. > [!NOTE] > When a process is downloaded from a bundle, all related assets, along with their configurations, are automatically imported to ensure seamless integration. ### **Install Selected Assets** 1. Access the **Admin** tab from the top menu, then click the **DevLink** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/DevLink Icon.png) from the left sidebar. 2. Click a linked instance to view available bundles. 3. Click the **Assets** tab to view available assets. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Installed Assets.png) 4. Click the **View** button next to an asset type to view relevant assets. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Data Connectors Assets.png) 5. Choose an asset and click the cloud icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Cloud Icon.png) to open the **Install Asset** window. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Install Asset.png) 6. In the window, select one of the following: 1. **Update:** Replace the existing asset with the latest version. 2. **Copy:** Create a new, separate version of the asset. 7. Click **Install** to begin the installation. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Installation Progress.png) 8. Once the installation is complete, the asset can be accessed from the **Designer Welcome Screen**. For example if the asset is a process, it appears in the [Process List](/v1/docs/view-edit-and-search-for-processes#view-active-and-inactive-processes). --- ### Reinstall a Bundle If an installed remote Bundle is updated, it can be re-installed using the following steps: 1. Access the **Admin** tab from the top menu, then click the **DevLink** icon ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/DevLink Icon.png) from the left sidebar. 2. Click on the **Local** **Bundles** tab to view available Bundles. 3. Click on a Bundle to open it. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Reinstall.png) 4. Click the **Reinstall** button to reinstall the Bundle. 5. If the bundle has no available updates, the following options are available: 1. Click **Add a Copy** to create a duplicate version of all assets in the Bundle. 6. If the remote instance has published a new version of the bundle, the following options are available: 1. Click **Update Bundle** to update the bundle with the latest available version. 2. Click **Add a Copy** to create a duplicate of the current bundle. ![](https://cdn.document360.io/2d311614-fcb7-4424-8b4c-d4d3091eebeb/Images/Documentation/Uodate Bundle.png) ## Related - [Designer Home Page](/designer-welcome-screen.md)