--- id: hosting title: Hosting --- Hosting is the process of deploying your application to the internet so that users can access it. This is a critical part of any web development project, ensuring your application is available to the world. TanStack Start is built on Vite, a powerful dev/build platform that allows us to make it possible to deploy your application to any hosting provider. ## What should I use? TanStack Start is **designed to work with any hosting provider**, so if you already have a hosting provider in mind, you can deploy your application there using the full-stack APIs provided by TanStack Start. However, since hosting is one of the most crucial aspects of your application's performance, reliability, and scalability, we recommend using one of our **Official Hosting Partners**: [Cloudflare](https://www.cloudflare.com?utm_source=tanstack) or [Netlify](https://www.netlify.com?utm_source=tanstack). ## Deployment > [!WARNING] > The page is still a work in progress. We'll keep updating this page with guides on deployment to different hosting providers soon! Once you've chosen a deployment target, you can follow the deployment guidelines below to deploy your TanStack Start application to the hosting provider of your choice: - [`cloudflare-workers`](#cloudflare-workers): Deploy to Cloudflare Workers - [`netlify`](#netlify): Deploy to Netlify - [`nitro`](#nitro): Deploy using Nitro - [`vercel`](#vercel): Deploy to Vercel - [`railway`](#nodejs--railway--docker): Deploy to Railway - [`node-server`](#nodejs--railway--docker): Deploy to a Node.js server - [`bun`](#bun): Deploy to a Bun server - ... and more to come! ### Cloudflare Workers ⭐ _Official Partner_ Cloudflare logo ### Cloudflare Workers When deploying to Cloudflare Workers, you'll need to complete a few extra steps before your users can start using your app. 1. Install `@cloudflare/vite-plugin` ```bash pnpm install @cloudflare/vite-plugin -D ``` 2. Update `vite.config.ts` Add the cloudflare plugin to your `vite.config.ts` file. ```ts // vite.config.ts import { defineConfig } from 'vite' import { tanstackStart } from '@tanstack/solid-start/plugin/vite' import { cloudflare } from '@cloudflare/vite-plugin' import viteSolid from 'vite-plugin-solid' export default defineConfig({ plugins: [ cloudflare({ viteEnvironment: { name: 'ssr' } }), tanstackStart(), viteSolid({ ssr: true }), ], }) ``` 3. Install `wrangler` ```bash pnpm add wrangler -D ``` 4. Add a `wrangler.json` config file ```json { "$schema": "node_modules/wrangler/config-schema.json", "name": "tanstack-start-app", "compatibility_date": "2025-09-02", "compatibility_flags": ["nodejs_compat"], "main": "@tanstack/solid-start/server-entry", "vars": { "MY_VAR": "Hello from Cloudflare" } } ``` 5. Modify package.json script ```json { "scripts": { "dev": "vite dev", "build": "vite build && tsc --noEmit", "start": "node .output/server/index.mjs", // ============ 👇 add this line ============ "deploy": "npm run build && wrangler deploy" } } ``` 6. Deploy ```bash pnpm run deploy ``` Deploy your application to Cloudflare Workers using their one-click deployment process, and you're ready to go! ### Netlify ⭐ _Official Partner_ Netlify logo ### Netlify Install and add the [`@netlify/vite-plugin-tanstack-start`](https://www.npmjs.com/package/@netlify/vite-plugin-tanstack-start) plugin, which configures your build for Netlify deployment and provides full Netlify production platform emulation in local dev. ```ts // vite.config.ts import { defineConfig } from 'vite' import { tanstackStart } from '@tanstack/solid-start/plugin/vite' import netlify from '@netlify/vite-plugin-tanstack-start' import viteSolid from 'vite-plugin-solid' export default defineConfig({ plugins: [tanstackStart(), netlify(), viteSolid({ ssr: true })], }) ``` Add a `netlify.toml` file to your project root: ```toml [build] command = "vite build" publish = "dist/client" [dev] command = "vite dev" port = 3000 ``` Deploy your application using their one-click deployment process, and you're ready to go! ### Nitro [Nitro](https://nitro.build/) is an abstraction layer that allows you to deploy TanStack Start applications to [a wide range of providers](https://nitro.build/deploy). **⚠️ During TanStack Start 1.0 release candidate phase, we currently recommend using:** - [@tanstack/nitro-v2-vite-plugin (Temporary Compatibility Plugin)](https://www.npmjs.com/package/@tanstack/nitro-v2-vite-plugin) - A temporary compatibility plugin for using Nitro v2 as the underlying build tool for TanStack Start. - [Nitro v3's Vite Plugin (ALPHA)](https://www.npmjs.com/package/nitro) - An **ALPHA** plugin for officially using Nitro v3 as the underlying build tool for TanStack Start. #### Using Nitro v2 **⚠️ `@tanstack/nitro-v2-vite-plugin` is a temporary compatibility plugin for using Nitro v2 as the underlying build tool for TanStack Start. Use this plugin if you experience issues with the Nitro v3 plugin. It does not support all of Nitro v3's features and is limited in its dev server capabilities, but should work as a safe fallback, even for production deployments for those who were using TanStack Start's alpha/beta versions.** ```tsx import { tanstackStart } from '@tanstack/solid-start/plugin/vite' import { defineConfig } from 'vite' import viteSolid from 'vite-plugin-solid' import { nitroV2Plugin } from '@tanstack/nitro-v2-vite-plugin' export default defineConfig({ plugins: [ tanstackStart(), nitroV2Plugin(/* // nitro config goes here, e.g. { preset: 'node-server' } */), viteSolid({ ssr: true }), ], }) ``` #### Using Nitro v3 (ALPHA) **⚠️ The [`nitro`](https://www.npmjs.com/package/nitro) vite plugin is an official **ALPHA** plugin from the Nitro team for using Nitro v3 as the underlying build tool for TanStack Start. It is still in development and is receiving regular updates.** ```tsx import { tanstackStart } from '@tanstack/solid-start/plugin/vite' import { defineConfig } from 'vite' import viteSolid from 'vite-plugin-solid' import { nitro } from 'nitro/vite' export default defineConfig({ plugins: [ tanstackStart(), nitro(/* // nitro config goes here, e.g. { config: { preset: 'node-server' } } */) viteSolid({ssr: true}), ], }) ``` ### Vercel Follow the [`Nitro`](#nitro) deployment instructions. Deploy your application to Vercel using their one-click deployment process, and you're ready to go! ### Node.js / Railway / Docker Follow the [`Nitro`](#nitro) deployment instructions. Use the `node` command to start your application from the server from the build output files. Ensure `build` and `start` npm scripts are present in your `package.json` file: ```json "build": "vite build", "start": "node .output/server/index.mjs" ``` Then you can run the following command to build your application: ```sh npm run build ``` You can start your application by running: ```sh npm run start ``` ### Bun Follow the [`Nitro`](#nitro) deployment instructions. Depending on how you invoke the build, you might need to set the `'bun'` preset in the Nitro configuration: ```ts // vite.config.ts import { tanstackStart } from '@tanstack/solid-start/plugin/vite' import { defineConfig } from 'vite' import viteSolid from 'vite-plugin-solid' import { nitroV2Plugin } from '@tanstack/nitro-v2-vite-plugin' // alternatively: import { nitro } from 'nitro/vite' export default defineConfig({ plugins: [ tanstackStart(), nitroV2Plugin({ preset: 'bun' }) // alternatively: nitro( { config: { preset: 'bun' }} ), viteSolid({ssr: true}), ], }) ```