Skip to main content
Version: Next

Deploy your app

Your recipe app runs locally. The last step is to put it online. The recommended path is Serverpod Cloud, which hosts your server and database with zero configuration.

Deploy to Serverpod Cloud​

Install the Serverpod Cloud CLI:

$ dart pub global activate serverpod_cloud_cli

From your project's root folder, launch the app. This creates a Cloud project, provisions a managed Postgres database (separate from the embedded one serverpod start runs locally), and deploys your server along with the web build of your app:

$ scloud launch

The first upload includes your Flutter web build and can exceed the default timeout on a slower connection. If the upload times out, retry with a higher limit (in seconds), for example, scloud launch --timeout 600.

Your Gemini API key lives in passwords.yaml, which stays on your machine and is never deployed. Set it as a secret in Cloud so the deployed server can call Gemini:

$ scloud password set geminiApiKey

Whenever you make changes later, redeploy with:

$ scloud deploy

See the Serverpod Cloud documentation for the full walkthrough, including custom domains, logs, and your free trial.

Other deployment options​

Prefer to host the server yourself? See Custom hosting for running on a server cluster, a serverless platform, or your own machine.

What you've built​

You've built and deployed a full-stack app with Flutter and Serverpod:

  • A custom endpoint that calls an external API from the server.
  • A type-safe data model shared between the server and the Flutter app.
  • Persistent storage with the database.
  • A Flutter app that talks to your server through the generated client.

We're excited to see what you'll build next. If you need help, join the Discord community or ask in our community on GitHub. To go deeper into any topic, browse the Concepts section.