--- title: "Overview" slug: "data-exchange-homag-file-agent-overview" updated: 2026-08-24T11:54:50Z published: 2026-08-24T11:54:50Z canonical: "docs.homag.cloud/data-exchange-homag-file-agent-overview" --- > ## Documentation Index > Fetch the complete documentation index at: https://docs.homag.cloud/llms.txt > Use this file to discover all available pages before exploring further. # Overview ## Overview The HOMAG File Agent is a software that HOMAG provides free of charge for you if your machine offers only limited or no connectivity or if no coordinated interface to your software is available in work preparation. With the HOMAG File Agent, you can also automate the data exchange between the machine/work preparation and the [productionManager](/v1/docs/en/productionmanager-tutorial-erste-schritte), [intelliDivide](/v1/docs/en/intellidivide-tutorial-erste-schritte) , and [materialManager](/v1/docs/en/materialmanager-tutorial-erste-schritte) for these use cases. ![HOMAG File Agent Konfiguration](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_File-Agent-01-de_c8c61f8f44.jpg?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) HOMAG File Agent Configuration The HOMAG File Agent monitors configured network drives, local directories or databases and automatically processes the files and entries stored in them. A whole range of tasks can be automated as a result. - Import order data into the productionManager. - Import BOMs into the productionManager and intelliDivide Cutting/Nesting. - [Processing feedback](/v1/docs/en/datenaustausch-homag-file-agent-rueckmeldungen-von-maschinen) from machines that cannot be connected to tapio - [Import of board materials from woodStore](/v1/docs/en/datenaustausch-homag-file-agent-import-von-plattenmaterialien-aus-woodstore) ## Installation The HOMAG File Agent is installed by you independently on an AV workstation computer. The installation and use of the HOMAG File Agent is at your own risk. A [warranty](/v1/docs/en/datenaustausch-homag-file-agent-gewaehrleistungsausschluss) for the HOMAG File Agent including updates is excluded The installation files must first be [downloaded](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/HomagFileAgentSetup.zip?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) and unpacked. All current Windows versions are supported. ![Entpacken der Installationsdatei](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_file-agent-unzip-01-de_1cd61b45fc.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Unzipping the installation file After installation, the HOMAG File Agent opens automatically. ![](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_file-agent-start-01-de_059138b990.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Later, you can access the HOMAG File Agent via the Windows menu or the icon in the taskbar. ![](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_file-agent-start-02-de_f29622edca.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) The HOMAG File Agent is executed automatically after the computer is restarted. You can adjust this in the settings if necessary. ![Zugriff auf die Einstellungen](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_file-agent-autostart-01-de_3554975af3.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Accessing Settings ![Aktivierung / Deaktivierung des automatischen Starts](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_file-agent-autostart-02-de_76991b4749.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Enable/disable auto-start > [!NOTE] > **Note:** The HOMAG File Agent can be installed on several end devices. ## Auto-updates The HOMAG File Agent automatically checks whether a newer version is available every time the program is started and updates itself, unless the auto-update has been deactivated. You can deactivate the auto-update in the settings of the HOMAG File Agent. Activating auto-updates is necessary for the HOMAG File Agent to work permanently with the cloud-based services [intelliDivide](/v1/docs/en/intellidivide-tutorial-erste-schritte) and [productionMananger](/v1/docs/en/productionmanager-tutorial-erste-schritte) . If you deactivate auto-update, the functionality of the connected services may be impaired. ![HOMAG File Agent Settings](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/HOMAG-File-Agent-Settings-01-de.jpg?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) HOMAG File Agent Settings ![HOMAG File Agent Auto Update](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/HOMAG-File-Agent-Settings-02-de.jpg?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) HOMAG File Agent Auto Update ## Configuration To link the HOMAG File Agent with the productionManager, intelliDivide and the materialManager, an authorization key (access token) is required. You can access this at [my.tapio.one](https://my.tapio.one) . The HOMAG File Agent is presented as a sublicense of productionManager , intelliDivide and materialManager. By clicking on the respective application, you will be taken to its detailed display. The HOMAG File Agent is displayed as a separate tile in the details. Note: Within the materialManager, the license is called **HOMAG File Agent woodStore**. ![Navigation zu my.tapio.one zum Abruf des Access Tokens](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/file-agent-token-01-de.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Navigation to my.tapio.one to retrieve the access token ![Navigation zur Applikation HOMAG File Agent unter my.tapio.one](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/file-agent-token-02-de.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Navigation to the HOMAG File Agent application at my.tapio.one ![Hinzufügen eines Berechtigungsschlüssels](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/file-agent-token-04-de.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Add a permission key ![Vergabe eines Namens für den Berechtigungsschlüssel](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/file-agent-token-05-de.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Assignment of a name for the authorization key ![Kopieren des Berechtigungsschlüssels](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/file-agent-token-06-de.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Copy the permission key ![Übernahme des Berechtigungsschlüssels in den HOMAG File Agent](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/file-agent-token-07-de.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Transfer of the authorization key to the HOMAG File Agent The authorization key can only be copied once. If necessary, you can generate a new key. After linking the HOMAG File Agent with tapio, the tasks to be automated (e.g. [import of parts lists](/v1/docs/en/datenaustausch-homag-file-agent-import-von-stuecklisten) , [confirmations from machines](/v1/docs/en/datenaustausch-homag-file-agent-rueckmeldungen-von-maschinen), [import of panel materials from woodStore](/v1/docs/en/datenaustausch-homag-file-agent-import-von-plattenmaterialien-aus-woodstore)) can be configured. ## Start automated processing After the actions to be performed have been configured, the processing can be started. ![Starten der Verzeichnisüberwachung](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_file-agent-import-parts-id-02-de_899b1606fd.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Starting Directory Monitoring Before adjusting the configuration, the HOMAG File Agent must first be stopped again. ![Stoppen der Verzeichnisüberwachung.](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_file-agent-stop-01-de_a5c159830a.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Stop directory auditing. ## Log of actions performed In the "Logs" tab, all actions performed by the HOMAG File Agent can be traced. Especially in the event of an error, solution hints can be found here. ![Protokoll der durchgeführten Aktionen im Reiter Logs.](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/csm_file-agent-log-01-de_e5ecd428bd.png?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D) Log of the actions performed in the Logs tab. --- ## References ### Data exchange - [Feedback from machines](/v1/docs/en/datenaustausch-homag-file-agent-rueckmeldungen-von-maschinen) - [Importing BOMs](/v1/docs/en/datenaustausch-homag-file-agent-import-von-stuecklisten) - [Import of board materials from woodStore](/v1/docs/en/datenaustausch-homag-file-agent-import-von-plattenmaterialien-aus-woodstore) --- ## Resources ### Download - [HOMAG File Agent](https://cdn.document360.io/43eaea7e-f51c-41df-9b73-bf55e0b1d20d/Images/Documentation/HomagFileAgentSetup.zip?sv=2026-02-06&spr=https&st=2026-11-09T23%3A35%3A06Z&se=2026-11-10T00%3A35%3A06Z&sr=c&sp=r&sig=yA8YCdjKA64H1BWSmnr2EuA62%2BW49rY9FQZejYHOIYE%3D)