Skip to main content

Install and configure LimeSurvey

The Ramon plugin supports self-hosted LimeSurvey CE 6.x and 7.x. It provisions Ramon surveys, injects the public embed configuration, maps a random Ramon UUID to a LimeSurvey response, supports administrator-led scoring and exports, and synchronizes deletion requests.

Prerequisites​

  • A versioned ramon-limesurvey-<version>.zip plugin artifact.
  • LimeSurvey CE 6.x or 7.x with the PHP cURL extension available.
  • A Ramon integration key from Ramon Admin → Integrations.
  • HTTPS for the production API URL. Local localhost, 127.0.0.1, and host.docker.internal HTTP URLs are accepted only for local development.

Installation​

  1. In LimeSurvey, open Configuration → Plugins, upload the ZIP, and activate Ramon.
  2. Open the plugin settings and enter the Ramon API URL and integration key.
  3. Save and run the native connection test beside the stable instance UUID.
  4. Activate a survey. Ramon provisions and enables it automatically unless that survey was explicitly disabled in its Ramon view.

The plugin stores the private Bearer key in LimeSurvey's native encrypted plugin settings. Survey pages receive only a public tracking key, collector URL, embed URL, and random UUID.

If CSP is enabled, allow the configured Ramon Embed origin in script-src and the Ramon API origin in connect-src.