Kolva connects to your ERP through a lightweight agent that runs on your company's network. This article covers installation, configuration, and troubleshooting for Sage X3 and SAP Business One.
How It Works
The Kolva agent is a self-contained binary — no runtime dependencies. It reads data from your ERP's database and pushes it to Kolva over HTTPS. All traffic is outbound: no inbound ports, no VPN, no firewall exceptions needed.
Installing the Agent
Download the agent from Settings > Integrationsin the Kolva dashboard. Choose your OS (Windows or macOS) and your ERP (Sage X3 or SAP). Run the installer and follow the setup wizard.
Configuration
The wizard asks for your database connection string (SQL Server for Sage X3, OData endpoint for SAP) and generates an API key. The API key is stored as a SHA-256 hash server-side — the plaintext never leaves your machine.
First Sync
Run the agent with the --discover flag to confirm connectivity and see available entities. Then run --sync for the initial data load. Subsequent syncs are delta-only, fetching only rows modified since the last run.
Troubleshooting
If the agent cannot connect, check that the database credentials have SELECT permission on the required schema. For network issues, verify that outbound HTTPS (port 443) is not blocked by your firewall. The agent logs to kolva-agent.log in the installation directory.