fresco 🠖 deployment

Troubleshooting 

You may encounter errors during deployment. Below are some common errors along with solutions or workarounds.

"Invalid API Key" error during Vercel deployment

You may encounter an error in your deployment such as "Invalid API Key", or "API keys must start with...".

This error means that you provided an incorrect environment variable. Make sure to enter the environment variable value correctly. You must enter the value that starts after = symbol (e.g: UPLOADTHING_APP_ID=5q5ybg9dwg, here UPLOADTHING_APP_ID is the key of variable and 5q5ybg9dwg is the value. You should always enter the value.)

Invalid API Key Console Error
Invalid API Key Console Error

"Instance Expired" message during the setup process

You may be redirected to a page that informs you that your instance has expired.

When completing the initial setup for Fresco, you have 2 hours to complete the process. If you exceed this time, you will be redirected to a page that informs you that your instance has expired. If this happens, you must delete your database and create a new one.

To delete your database:

  1. Navigate to your database on the dashboard by selecting Storage and then selecting your database.

    Select database
    Select database

  2. Select the Projects tab, check the box next to your project, and select Remove Project Connection from the dropdown.

    Remove project connection
    Remove project connection

  3. Select Remove Connection to confirm.

    Remove connection
    Remove connection

  4. Select the Settings tab and select Delete Database from the Delete Store section.

    Delete Database
    Delete Database

  5. After confirming, you can follow the instructions again to Create a Database

Protected URL issue

You may encounter an issue where your Fresco URL is protected and prompts login through Vercel.

This error means that you are using the deployment specific URL, which requires login through Vercel to access. To resolve this issue, use the domain URL provided by Vercel. To find the correct URL:

  1. Navigate to your project dashboard. This will be in the format https://vercel.com/<username>/<project-name>.

  2. Select the Project tab.

  3. Click Visit or the URL in the Domains section. Do not use the URL in the Deployment section as it is protected.