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

# Troubleshooting

> Resolve common Visual Layer issues including dataset creation errors, warnings, and general platform problems.

This section addresses common issues and provides troubleshooting tips to help you resolve problems with Visual Layer.

## Dataset Creation Errors

Errors completely prevent dataset creation. Datasets with errors appear first in the inventory with "Error creating Dataset" displayed instead of a progress bar.

### Common Error Types

<div className="integrations-table">
  | Error Type                            | Impact                 | Solution                                                                                                                  |
  | ------------------------------------- | ---------------------- | ------------------------------------------------------------------------------------------------------------------------- |
  | **File uploaded is corrupted**        | Dataset creation fails | Ensure the file was properly saved or exported. Verify the file format is supported. Try uploading in a different format. |
  | **File is protected by password**     | Dataset creation fails | Remove password protection from the compressed file and retry.                                                            |
  | **Dataset image limitation exceeded** | Dataset creation fails | Split the dataset or upload a subset of images.                                                                           |
  | **Dataset file size exceeded**        | Dataset creation fails | Split the dataset or convert images to a different format.                                                                |
  | **Internal server error**             | Dataset creation fails | Retry dataset creation. Contact support if the problem persists.                                                          |
</div>

## Dataset Creation Warnings

Warnings allow dataset creation but limit functionality. Successfully created datasets display a warning indication in the header. Hover over the indicator to view details.

### Common Warning Types

* Annotations were not in the expected format
* Too many objects in the dataset (over 1M objects)

## Self-Hosting Installation Errors

### Image Not Found

```sh theme={"theme":"monokai"}
docker: Error response from daemon: pull access denied for visuallayer/onprem-installer, repository does not exist or may require 'docker login'.
```

**Solution**: Ensure you are logged into Docker.

### Docker Daemon Not Running

```sh theme={"theme":"monokai"}
docker: Cannot connect to the Docker daemon at unix:///var/run/docker.sock.
```

**Solution**: Start the Docker daemon.

### Image Pulling Fails

```sh theme={"theme":"monokai"}
manifest for visuallayer/onprem-cd:2.25.6-rc6 not found: manifest unknown
```

**Solution**: Verify the software version and that you are logged into Docker with the correct user.

### Platform Mismatch Warning

```sh theme={"theme":"monokai"}
WARNING: The requested image's platform (linux/arm64) does not match the detected host platform (linux/amd64/v3).
```

**Solution**: This is a warning only and can be ignored.

### `docker compose` Not Found

```sh theme={"theme":"monokai"}
./run_profiler.sh: line 159: docker compose: command not found
```

**Solution**: Install or reinstall Docker following the official installation instructions.

### PostgreSQL Operational Error

```sh theme={"theme":"monokai"}
sqlalchemy.exc.OperationalError: (psycopg.OperationalError) [Errno -3] Temporary failure in name resolution
```

**Solution**: Ensure the system was brought up using the `docker up` command.

## Still Need Help?

Contact our support team at [support@visual-layer.com](mailto:support@visual-layer.com) for further assistance. When reporting issues, include:

* Error messages or warnings you encountered
* File types and formats you attempted to upload
* Steps you took before encountering the problem
* Screenshots if applicable