Portainer icon

Portainer

Work with Portainer API data to manage Docker

System → Get Version

AI-generated

Overview

This node interacts with the Portainer API to retrieve system information, specifically the Portainer version when the 'Get Version' operation is selected under the 'System' resource. It is useful for scenarios where users need to programmatically check the version of the Portainer instance they are managing, such as in automation workflows or monitoring setups.

Use Case Examples

  1. Retrieve the current Portainer version to verify compatibility before deploying new containers.
  2. Check the Portainer version as part of a system health check workflow.

Properties

Name Meaning
Request Options Settings to control request behavior such as batching, SSL certificate validation, proxy usage, and timeout duration.

Output

JSON

  • version - The Portainer version information retrieved from the API response.

Dependencies

  • Requires an API key credential for authenticating with the Portainer API.

Troubleshooting

  • Ensure the API key credential is correctly configured and has sufficient permissions to access system information.
  • If SSL issues occur, consider enabling the 'Ignore SSL Issues' option, but be aware of security implications.
  • Verify the base URL of the Portainer API is correct and accessible from the n8n environment.
  • Timeout errors may occur if the server is slow to respond; adjust the timeout setting accordingly.

Links

Discussion