Skip to main content

Deploy with an agent

Copy agent prompt

Before you start

Connect your AWS account using the Spring Winter quickstart. You need a database that matches your Payload adapter and durable upload storage. Check the upstream deployment instructions and pin a release before you deploy. Source repository.

Create and connect the database

  1. Create a private SQL database with PostgreSQL for the PostgreSQL adapter. If you already have a database for this deployment, verify that the engine and version match the pinned app release. Wait for the database to be ready.
  2. Open Connect on the database. Use the writer endpoint, port, database name and application credentials. Create the application database and role if needed. Confirm that the application and migration process can reach the private writer.
  3. Set DATABASE_URL or the connection variable read by your Payload configuration. If the project uses another adapter, provision its supported engine instead. Put secret values in runtime configuration or the migration process’s secret store.
  4. Run the project’s production migrations with access to the writer. Deploy the web service after they succeed.

Configure the deployment

  1. Select a Spring Winter project in the AWS Region you want to use. Use a web server for the HTTP app and configure dependencies before you start it.
  2. Deploy your own Payload Next.js project from GitHub using its production Dockerfile.
  3. With the PostgreSQL adapter, provision PostgreSQL and supply the connection variable your config reads, typically DATABASE_URL.
  4. Supply PAYLOAD_SECRET at runtime.
  5. Configure the S3 storage adapter for uploads and use the project’s documented migration command before rollout.
When you run the HTTP app on Spring Winter, set a health path that returns HTTP 200 without signing in. Use Runtime variables for runtime configuration. Task storage is temporary. Verify that every file you need after replacement goes to durable storage.

Verify the deployment

Check the deployment in History if you created Spring Winter compute. Wait for the workflow to succeed, then test the application over HTTPS. Sign in to /admin and create and retrieve a test document and upload.