Self-Hosted
Deploy Syntext documentation to your own infrastructure
While Syntext provides managed hosting with global CDN and SSL, you can also deploy the generated static files to your own infrastructure.
Self-hosted deployment is available on Enterprise plans. Contact us to learn more.
Build for Self-Hosting
Generate the static site with the CLI. The build runs on Syntext and the finished files are downloaded to your machine:
--token takes a project API key; on your own machine, stx login works instead. This creates a dist/ folder containing:
Pages are flat .html files — configure your host to resolve extensionless URLs (see the Nginx example below).
Hosting Options
Static Site Hosting
Deploy to any static file host:
AWS S3 + CloudFront
Cloudflare Pages
Nginx
Docker
Build a containerized version:
Self-Hosted Features
Search
Every stx build includes a static search index:
_assets/search-index.json automaticallyClient-side search works well for small-to-medium sites (< 500 pages). For larger sites, consider a dedicated search service.
AI Assistant
A self-hosted export has no built-in AI assistant, and the ai key in syntext.json has no effect. To give readers an assistant on pages you host, embed the chat widget.
Analytics
Self-hosted deployments don't include Syntext analytics by default. Options:
stx build downloads. See also Custom code from your docs.scripts in syntext.json is not applied by builds.
Continuous Deployment
GitHub Actions (Self-Hosted)
Limitations
Self-hosted deployments don't include:
| Feature | Self-Hosted | Managed |
|---|---|---|
| Global CDN | ❌ | ✅ |
| Automatic SSL | ❌ | ✅ |
| Preview deployments | ❌ | ✅ |
| Built-in analytics | ❌ | ✅ |
| AI assistant (default) | ❌ | ✅ |
| AI-powered search | ❌ (static search index only) | ✅ |
You can replicate these features with your own infrastructure, but it requires additional setup.