Rofy|Rofy Help
Troubleshooting

Deployment Related Issues

Common deployment issues on Rofy and how to troubleshoot them.

Deployment Related Issues

This guide explains some common problems you may encounter while deploying apps on Rofy, along with simple ways to diagnose and fix them.

Info
This list is not exhaustive. If you face an issue not covered here, refer to the other guides in the Troubleshooting section.

Overview

Deployment is the process of moving your application from a temporary preview environment to a permanent live application.

PreviewDeployment
Temporary testing environmentPermanent live application
Stops after 30 minutes of inactivityAlways online
Used for development and testingUsed by real users

In simple terms, deployment moves your app from one workspace to another.

During this process, some configuration issues may appear. Below are the most common ones and how to fix them.

Issue 1: Missing API Configurations

Many apps depend on external services such as:

  • Sending emails
  • Processing payments (Stripe)
  • Using AI models (OpenAI)
  • Connecting to databases

Each of these services requires an API key (similar to a password).

During development, these keys might exist locally, but during deployment they must be provided to Rofy via environment variables.

How to Identify This Issue

Your app deploys successfully but:

  • Some features stop working
  • Console shows errors like "undefined"
  • Errors like "missing API key" appear
  • External integrations fail

Example Prompt to Fix It

You can ask the agent:

On this page