Getting Started¶
This guide walks you through installing and configuring your first module.
1. Login¶
Go to app.tevyra.com and log in with your credentials.
If two-factor authentication is enabled, enter the code received by email or from your authentication app (Google Authenticator, Bitwarden, etc.).
2. Select a workspace¶
If you have access to multiple tenants (workspaces), select the one you want to configure using the selector in the sidebar.
3. Install a module¶
- Go to Settings > App Store
- Browse the catalog or use the search bar
- Click Install on the desired module
The module is installed but remains inactive. You must configure it before activating.
4. Configure the module¶
- Click Configure next to the installed module
- Fill in the required fields (tool URL, login credentials, etc.)
- Click Test connection to verify everything works
- Activate the module
- Click Save
Module documentation
Each module has its own documentation page with configuration details:
- Active Directory — AD identity sync
- Freescout — Support ticket management
- Microsoft 365 — M365 users, groups, and licenses
- Zabbix — Infrastructure monitoring
5. View your data¶
Once the module is activated, data starts syncing automatically. Go to the module dashboard to view it.
6. Refresh the module catalog¶
To check for new available modules:
- Go to Settings > App Store
- Click Refresh
Install the Proxy (if needed)¶
Some modules require a Tevyra Proxy installed in your network to access internal tools (Active Directory, Zabbix on-premise, etc.).
Deploy with Docker¶
docker run -d \
--name tevyra-proxy \
--restart unless-stopped \
-e TEVYRA_API_URL=https://api.tevyra.com \
-e TEVYRA_PROXY_TOKEN=your-token \
registry.gitlab.com/tevyra/tevyra-proxy:latest
Get the proxy token¶
- Go to Settings > Proxies
- Click Add a proxy
- Copy the generated token and paste it into the
TEVYRA_PROXY_TOKENvariable
The proxy connects automatically to Tevyra and appears in the active proxies list.
No ports to open
The proxy only communicates outbound to api.tevyra.com (HTTPS, port 443). No inbound ports need to be opened on your firewall.