---
title: Updating a collector automatically
slug: how-tos/g3ad-updating-a-collector
createdAt: 2025-09-05T09:46:12.741Z
---

This page explains how to **update collectors automatically** from within Factry Historian. Updates can be fetched directly from the portal or manually uploaded if needed.

## Enabling update checks

To allow Historian to automatically check for collector updates:

1. Go to `Configuration > General > Collector Updates`
2. Enable **Allow Historian to check for collector updates**
3. Optionally, adjust the **update check interval** to your preferred frequency

## Available updates overview

Navigate to `Configuration > Updates` to see all updates that are available, either fetched automatically or manually uploaded.

The updates page shows:

- Version
- Operating System
- Architecture

## Manually uploading an update

Updates can be uploaded manually if automatic update checks are not configured or Factry Historian does not have access to the Client Portal.

Two files are required:

1. The **update binary**
2. The **update metadata file**

These files can be downloaded from the [Client Portal](https://portal.factry.cloud) or provided by Factry support.

To upload the files, click the **Upload** button on the Updates page and select the files.

## Updating a collector

1. In the **Collectors Overview** page, collectors that can be updated show the **Update available** icon.
2. Click the collector to view its **details page**, showing the current version and the latest available version.
3. Click **Install Update** and select the version to which you want to update.
4. Click **Submit**. The update file will be sent to the collector, which will then update itself and restart automatically.

The update progress can be tracked in:

- The collector’s **Health History**
- The **Collectors Overview** page

## Expected outcome

After updating a collector:

- The collector runs the new version
- It reconnects automatically to the Historian
- Existing measurements continue without interruption
- The **Collectors Overview** page shows the updated version

## Troubleshooting

### Collector fails to update

- Check network connectivity between the Historian and the collector
- Verify the update file is correct and not corrupted
- Ensure sufficient permissions to write/update files on the collector host

### Collector restarts but does not appear online

- Confirm the collector service restarted successfully
- Review logs on the collector host for errors
- Verify the collector is configured with the correct API URL and token

### Automatic updates not appearing

- Check that **Allow Historian to check for collector updates** is enabled
- Ensure the Historian can access the Client Portal
- Refresh the `Updates` page after some time to see newly fetched updates