> ## Documentation Index
> Fetch the complete documentation index at: https://developers.entri.com/llms.txt
> Use this file to discover all available pages before exploring further.
# Getting Started
> Your first Entri integration in 5 minutes
Welcome to Entri! This guide will walk you through your first integration.
New to DNS? Check out [DNS Concepts](/dns-concepts) for a quick primer on record types, propagation, and common gotchas.
## 1. Set up your dashboard
Before writing code, configure your application in the [Entri Dashboard](https://dashboard.entri.com):
1. Sign up or log in
2. Create an application
3. Set your display name and icon (PNG or SVG, 1:1 ratio, white or transparent background)
4. Copy your `applicationId` and `secret`
## 2. Install Entri
Choose your preferred installation method:
```html HTML (CDN) theme={null}
```
```bash npm theme={null}
npm install entrijs
```
If using npm, import it in your code:
```javascript theme={null}
import Entri from 'entrijs';
```
**Subresource Integrity (SRI):** If your security policy requires SRI, load Entri via the pinned loader URL with its SHA-384 hash:
```html theme={null}
```
The loader at `entri-latest.js` is immutable, so the integrity hash above stays valid across Entri SDK releases — no need to update it on each version.
Because the loader fetches the SDK asynchronously, `window.entri` isn't available immediately. Wait for the `entri:ready` event before calling `showEntri()`:
```javascript Callback theme={null}
function onEntriReady(cb) {
if (window.entri) return cb(window.entri);
window.addEventListener("entri:ready", () => cb(window.entri), { once: true });
}
onEntriReady((entri) => {
entri.showEntri(/* …config… */);
});
```
```javascript Promise theme={null}
const entriReady = new Promise((resolve) => {
if (window.entri) return resolve(window.entri);
window.addEventListener("entri:ready", () => resolve(window.entri), { once: true });
});
entriReady.then((entri) => entri.showEntri(/* …config… */));
```
## 3. Get a JWT token
For security, fetch the JWT on your **server-side**. The token expires after 60 minutes.
Never expose your `secret` in client-side code. Always fetch the JWT from your backend.
```javascript JavaScript theme={null}
fetch('https://api.goentri.com/token', {
method: 'POST',
headers: {
'Content-Type': 'application/json'
},
body: JSON.stringify({
applicationId: "YOUR_APP_ID", // From the dashboard
secret: "YOUR_SECRET" // From the dashboard
}),
})
.then(response => response.json())
.then(data => {
console.log('Token:', data.auth_token);
// Save this token to use in step 4
})
.catch(error => console.error('Error:', error));
```
```python Python theme={null}
import requests
import json
url = "https://api.goentri.com/token"
payload = {
"applicationId": "YOUR_APP_ID", # From the dashboard
"secret": "YOUR_SECRET" # From the dashboard
}
headers = {"Content-Type": "application/json"}
response = requests.post(url, headers=headers, data=json.dumps(payload))
if response.ok:
data = response.json()
print("Token:", data["auth_token"])
# Save this token to use in step 4
else:
print("Error:", response.text)
```
## 4. Launch the Entri modal
With your token ready, launch the Entri modal:
```javascript theme={null}
entri.showEntri({
applicationId: "YOUR_APP_ID",
token: "YOUR_JWT_TOKEN", // From step 3
dnsRecords: [
{
type: "CNAME",
host: "www",
value: "your-app.com",
ttl: 300
}
]
});
```
MX records require a `priority` field. See [DNS Records](/api-reference#supported-record-types) for all record types.
## 5. Handle events
Listen for completion and close events:
```javascript theme={null}
entri.showEntri({
applicationId: "YOUR_APP_ID",
token: "YOUR_JWT_TOKEN",
dnsRecords: [...],
// Called when DNS setup completes successfully
onSuccess: (data) => {
console.log('Domain configured:', data.domain);
// { domain: "example.com", success: true, setupType: "automatic", ... }
},
// Called when the modal is closed
onEntriClose: (data) => {
console.log('Modal closed:', data);
}
});
```
## Complete example: React
Here's a full working example with React:
```jsx theme={null}
import { useEffect, useState } from 'react';
function DomainSetup() {
const [token, setToken] = useState(null);
useEffect(() => {
// Fetch JWT from your backend
fetch('/api/entri-token')
.then(res => res.json())
.then(data => setToken(data.token));
}, []);
const handleSetup = () => {
if (!token) return;
entri.showEntri({
applicationId: "YOUR_APP_ID",
token: token,
dnsRecords: [
{
type: "CNAME",
host: "www",
value: "your-app.com",
ttl: 300
}
],
onSuccess: (data) => {
console.log('Success:', data);
// Update your UI or backend
}
});
};
return (
);
}
export default DomainSetup;
```
For more framework-specific examples, see our [React Integration Guide](/integration/react) and [Vanilla JS Guide](/integration/vanilla-js).
## Next steps
Now that you have the basics working, explore Entri's products:
Automated DNS configuration for 60+ providers
Let users purchase domains in your app
Automatic SSL certificate provisioning
Custom domain management for your users
## Dive deeper
All showEntri() options
Complete events documentation
Server-side notifications
Understanding DNS records
## Need help?
We're here to help! Email us at [support@entri.com](mailto:support@entri.com) or reach out to your account manager.
## 2. Install Entri
Choose your preferred installation method: