Deployment
Find answers to common web deployment issues.
Deployment build fails
This is most likely an issue related to the environment variables not being set correctly in the deployment environment. Please analyse the logs of the deployment provider to see what is the issue.
The kit is very defensive about incorrect environment variables, and will throw an error if any of the required environment variables are not set. In this way - the build will fail if the environment variables are not set correctly - instead of deploying a broken application.
Check our guides for the most popular hosting providers for more information on how to deploy your TurboStarter project correctly:
Vercel
Deploy your TurboStarter web app to Vercel platform.
Netlify
Deploy your TurboStarter web app to Netlify platform.
Render
Deploy your TurboStarter web app to Render platform.
Railway
Deploy your TurboStarter web app to Railway platform.
Docker
Containerize your TurboStarter web app using Docker.
Fly.io
Deploy your TurboStarter web app to Fly.io platform.
What should I set as a URL before my first deployment?
That's very good question! For the first deployment you can set any URL, and then, after you (or your provider) assign a domain name, you can change it to the correct one. There's nothing wrong with redeploying your project multiple times.
Sign in with OAuth provider doesn't work
This is most likely a settings issues in the provider's settings. To troubleshoot this issue, follow these steps:
- Verify provider settings: Ensure that the OAuth provider's settings are correctly configured. Check that the client ID, client secret, and redirect URI are accurate and match the values in your application.
- Check environment variables: Confirm that the environment variables for the OAuth provider are set correctly in your application production environment.
- Validate callback URLs: Ensure that the callback URLs for each provider are set correctly and match the URLs in your application. This is crucial for the OAuth flow to work correctly.
Please read Better Auth documentation for more information on how to set up third-party providers.
Last updated on