Skip to main content

Frequently Asked Questions

Help

Quick answers to common questions. For deeper dives, follow the links into the rest of the docs.

Account and plans​

What does the Free plan include?​

A 30-day trial with the full feature set unlocked: job scheduling, version history, Git integration, SSO, organization groups, unlimited connectors, unlimited record volume, log integration, and the AI Builder (with a generous trial cap). The only constraints are a single environment and the shared runtime VM.

What happens when my trial expires?​

Sign-in routes you to a "Free trial ended" page nudging upgrade. Your data is preserved indefinitely. Upgrade unblocks access; no data migration needed.

Can I get my trial extended?​

Yes. Reach out and an internal admin can extend your trial from Admin Center -> Accounts -> Extend trial. The platform-wide default duration is also adjustable per release.

Connections​

Why does Test Connection fail?​

The most common causes are firewall rules between the runtime and the system, expired credentials, or environment-specific config (host/port differs in DEV vs Prod). Test Connection requires a runtime mapped to the selected environment.

Can I move a connection between environments?​

Yes -- Connections support encrypted export / import. Both backends must share the same connection-transfer secret configured by your operator. See Connections.

How are secrets stored?​

Per-connection secrets (passwords, API keys, OAuth tokens) are wrapped with a per-account crypto envelope and never returned to the browser in plaintext. The Connection Edit modal shows ******** for stored secrets; leave the field as-is to keep the existing value.

Why doesn't my OAuth connection work?​

Three common pitfalls:

  • Microsoft Entra requires the redirect URI to be type Web, not Single-page application (SPA).
  • Google's redirect URI must EXACTLY match the callback shown in the DataLug modal (case, slash, trailing path all matter).
  • Salesforce Connected Apps need time to finish provisioning after creation; wait a few minutes before testing.

Workflows and nodes​

What's the difference between a workflow and a pipeline?​

A workflow is an execution graph on the canvas (Source, Transform, Load, etc.). A pipeline is a higher-level container that can chain workflows together (used when enabled).

What does Quick Debug Run do?​

Pulls 10 rows from the source, walks them through the flow, and DRY-RUNS targets (Load nodes preview but don't write). You can iterate on transforms and validate output without affecting production data.

How do I run a flow on a schedule?​

Open Jobs -> Add Job, pick the project + workflow + environment, set the cron expression, save. The first scheduled fire writes a Runtime Execution record.

Runtime and execution​

Where do I see what happened during a run?​

Monitor -> Runtime Executions. Each row expands to show run log, per-node metrics, and (when enabled) per-node payload samples. Use ?projectId=<id>&runId=<id> to deep-link directly.

Why is my run "stuck"?​

Check Environments -> the env -> Runtime Agents for agent health. If the agent's last updated timestamp is more than a few minutes old, the runtime is offline. Free-plan accounts use the shared runtime; paid plans have dedicated hosted runtimes.

Can I cancel a running job?​

Yes -- use the Cancel / Stop controls on the Jobs page. Cancellation is best-effort; nodes mid-write may complete the row in flight before honouring the signal.

AI Builder (Milo)​

Which LLM does the AI Builder use?​

Operator-configurable. Defaults to OpenAI; can switch to self-hosted Ollama (via Open WebUI) without a backend restart. The card footer shows which provider is currently wired up.

Why does Apply reject my draft?​

The Apply contract requires a Start node with an outgoing edge. If you see "Milo draft is missing a Start node", click New Chat or Refresh suggestions and Milo will regenerate.

Can I customise the planner's prompts?​

Customer-side prompt customisation is coming soon. In the meantime, contact your DataLug operator team to adjust planner / chat models and provider configuration for your account.

Connectors and integrations​

Do you support <system X>?​

Browse Connectors for the current catalog. If your system speaks HTTP and has an OpenAPI spec (or you can describe the endpoints), the Generic API connector handles most cases.

Why are my Google Drive / OneDrive files not showing up?​

OAuth scope is the usual culprit. The connection wizard requests the minimal scope for file listing; if you need to write files, the saved action must request the write scope and the user must re-consent.

Troubleshooting​

"Unexpected token '<' ... is not valid JSON"​

This is a frontend talking to a frontend response: the backend returned an HTML error page (typically a 500 or a 502 from the proxy) and the client tried to parse it as JSON. Check the backend logs and the runtime is healthy.

My iframe shows a blank panel in Admin Center -> Diagnostics​

The customer VM lives in a private VPC; the iframe goes through a backend reverse proxy. The Reload button on the live viewer re-mounts the iframe. If it stays blank, click Open in new tab (operators on the VPC can reach the raw URL).

I can't find a doc I'm looking for​

Use the sidebar to browse, or jump to the Get started page for an orientation map.