Frequently Asked Questions
Find answers to common questions about deploying and managing your projects on Tannur.
What does Tannur do?▼
Tannur is a serverless deployment platform. You provide your project slug and build commands, and Tannur handles deployment, domain binding, SSL certificates, and automatic scaling.
How do I deploy my project?▼
Use the REST API to send a POST request to /api/projects/{projectId}/provision with your project slug and build commands. You'll receive a provisioning ID to track deployment progress.
What's a provisioning ID?▼
A provisioning ID (format: pvn_*) is returned when you start deployment. You use it to poll the status endpoint and track real-time progress until your project is live.
How long does deployment take?▼
Typically 2-3 minutes. This includes project creation, domain binding, environment setup, build execution, and SSL verification.
What project types does Tannur support?▼
Any project that has an HTTP server and uses standard build tools: Node.js, React, Vue, Python, Go, Ruby, .NET, Java, and more. If it has npm scripts or a build command, Tannur can deploy it.
How do I set environment variables?▼
Use the /api/projects/{projectId}/env-vars endpoint to set environment variables. They're injected during the build and runtime phases.
Can I use a custom domain?▼
Yes! Every project gets a free subdomain (my-app.tannur.xyz). You can also configure custom domains through the dashboard.
Is HTTPS included?▼
Yes, HTTPS is automatic and free. SSL certificates are provisioned and managed for all projects.
What happens if deployment fails?▼
The status endpoint shows the failed step and error details. You can check logs in the dashboard and retry provisioning after fixing the issue.
How do I check deployment logs?▼
Once provisioning starts, logs are available via the logs endpoint or in the dashboard under your project's Logs tab. Logs stream in real-time during deployment.
Can I integrate with CI/CD?▼
Absolutely. You can use GitHub Actions, GitLab CI, or any CI/CD platform. Just set your API token as a secret and call the provisioning endpoint in your pipeline.
What's my rate limit?▼
Free tier: 60 requests/minute globally, 30 POST requests/minute per endpoint. See API documentation for tier-specific limits.
How do I get my API token?▼
Log in to dashboard.tannur.xyz, go to Settings → API Tokens, and click Generate New Token. Store it securely in an environment variable.
What if I lose my API token?▼
Generate a new one from the dashboard. Old tokens are immediately invalidated. You can have multiple active tokens.
Can I deploy the same project multiple times?▼
Yes, each provisioning request creates a new deployment. You can use the same provisioning ID to check status, or start a new provisioning for updates.
What happens to my project after deployment?▼
Your project runs continuously and scales automatically. You can view metrics, logs, and manage settings from the dashboard.
How do I troubleshoot deployment issues?▼
Check the logs in the dashboard or via the logs endpoint. Common issues: build command fails, missing dependencies, or startup command not specified. See Troubleshooting guide for more.
Is there a free tier?▼
Yes! The free tier includes: 1 project, 60 API requests/minute, basic logging, and standard subdomains (*.tannur.xyz).
Still have questions?
Can't find what you're looking for? Check out our full documentation or reach out to support.
Ctrl+I
