Skip to main content
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

Error TypeImpactSolution
File uploaded is corruptedDataset creation failsEnsure the file was properly saved or exported. Verify the file format is supported. Try uploading in a different format.
File is protected by passwordDataset creation failsRemove password protection from the compressed file and retry.
Dataset image limitation exceededDataset creation failsSplit the dataset or upload a subset of images.
Dataset file size exceededDataset creation failsSplit the dataset or convert images to a different format.
Internal server errorDataset creation failsRetry dataset creation. Contact support if the problem persists.

​
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

Solution: Ensure you are logged into Docker.

​
Docker Daemon Not Running

Solution: Start the Docker daemon.

​
Image Pulling Fails

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

​
Platform Mismatch Warning

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

​
docker compose Not Found

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

​
PostgreSQL Operational Error

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

​
Still Need Help?

Contact our support team at 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