Tannur

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