> ## Documentation Index
> Fetch the complete documentation index at: https://docs.atomscale.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Files and Logs

> Where a gateway stores its program, settings, queued data, and logs, and how to collect logs for support

## Locations

The desktop app stores everything for the current Windows user under `%APPDATA%\Atomscale`.

| Path | Contents |
| - | - |
| `%LOCALAPPDATA%\Programs\Atomscale\` | The desktop app program, unless another folder was chosen during installation. |
| `%APPDATA%\Atomscale\app-settings.json` | App settings, such as the application mode and automatic updates. |
| `%APPDATA%\Atomscale\logs\main.log` | The application log. Rotates at 5 MB, keeping one previous file as `main.old.log`. |
| `%APPDATA%\Atomscale\logs\installer.log` | The installer log. |
| `%APPDATA%\Atomscale\gateway\` | Gateway data: identity, settings, integrations, and their queues (see below). |

### Gateway Folder

| Path under `%APPDATA%\Atomscale\gateway\` | Contents |
| - | - |
| `registry.json` | Installed integrations and their configurations. |
| `settings.json` | Upload bandwidth and concurrency. |
| `connection-sharing.json` | Connection Sharing mode, Hub port, and Outpost address. |
| `device-id`, `device-secret` | The gateway's identity. Don't copy these to another computer or share them. |
| `logs\activity-YYYY-MM-DD.jsonl` | Integration activity logs, one file per day (UTC), kept for about 24 hours. |
| `adapters\<integration ID>\` | One folder per installed integration: its program files and a `state` folder holding its upload queue. |

> [!WARNING]
>
> Don't delete or edit files in the gateway folder while the app is running. Deleting an
> integration's `state` folder deletes data that hasn't been uploaded yet. Use the app to uninstall
> integrations instead.

[Integration admin access](https://docs.atomscale.ai/gateway/admin-access.md) also creates machine-wide folders under `C:\Program Files` and `C:\ProgramData`; see [What It Installs](https://docs.atomscale.ai/gateway/admin-access.md#what-it-installs).

## Collecting Logs for Support

When contacting Atomscale support about a gateway problem, send:

**1. The application log**

Open **Settings**, and under **Diagnostics** click Open log folder. Send `main.log` and, if
present, `main.old.log`.

**2. The integration activity logs**

Open the affected integration, scroll to **Activity Logs**, and click Open logs directory.
Send the files for the days the problem occurred.

**3. The integration configuration**

On the integration's **Configure** page, click Copy configuration and paste it into your
message.

**4. Admin access details, if relevant**

For problems with integration admin access, also send the launcher log and Event Viewer errors
described in [Integration Admin Access](https://docs.atomscale.ai/gateway/admin-access.md#troubleshooting).

Activity log files are kept for about 24 hours. Collect them soon after a problem occurs.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.