Working with Apps

After deploying your code to a hosting platform, it is time to go to production and inform Inngest about your apps and functions. Check what Inngest Apps are if you haven't done it yet.

Sync a new app in Inngest Cloud

You can synchronize your app with Inngest using three methods:

  • Manually;
  • Automatically using an integration;
  • With a curl command.

Manually

  1. Select your environment (for example, "Production") in Inngest Cloud and navigate to the Apps page. You’ll find a button named “Sync App” or “Sync New App”, depending on whether you already have synced apps.
Inngest Cloud screen with sync App button when you have no apps synced yet Inngest Cloud screen with sync new app button when you have apps synced
  1. Provide the location of your app by pasting the URL of your project’s serve() endpoint and click on “Sync App”.
Sync New App form where you paste your project’s serve endpoint to inform Inngest about the location of your app
  1. Your app is now synced with Inngest. 🎉
Inngest Cloud screen with apps

Automatically using an integration

Curl command

Use the curl command to sync from your machine or automate the process within a CI/CD pipeline.

Send a PUT request to your application's serve endpoint using the following command:

curl -X PUT https://<your-app>.com/api/inngest

Before syncing with Inngest, ensure that the latest version of your code is live on your platform. This is because some platforms have rolling deploys that take seconds or minutes until the latest version of your code is live.

This is especially important when setting up your own automated process.

How and when to resync an app

To ensure that your functions are up to date, you need to resync your app with Inngest whenever you deploy new function configurations to your hosted platform.

If you are syncing your app through an integration, this process is automatically handled for you.

When to resync Vercel apps manually

We recommend using our official Vercel integration, since the syncing process is automatic. You will want to resync a Vercel app manually if:

  • There was an error in the automatic syncing process (such as a network error)
  • You chose not to install the Vercel integration and synced the app manually

If you have the Vercel integration and resync the app manually, the next time you deploy code to Vercel, the app will still be automatically resynced.

Vercel generates a unique URL for each deployment. Please confirm that you are using the correct URL if you choose a deployment's generated URL instead of a static domain for your app.

How to resync manually

  1. Navigate to the app you want to resync. You will find a “Resync” button at the top-right corner of the page.
Inngest Cloud screen with resync app button
  1. You will see a confirmation modal. Click on “Resync App”.
Inngest Cloud screen with resync app modal

If your app location changes, enable the "Override" switch and edit the URL before clicking on "Resync App". Please ensure that the app ID is the same, otherwise Inngest will consider it a new app white resyncing.

Inngest Cloud screen with resync app modal displaying an edited URL

Archive an app

Apps can be archived and unarchived at any time. Once an app is archived, all of its functions are archived.

When the app is archived:

  • New function runs will not be triggered.
  • Existing function runs will continue until completion.
  • Functions will be marked as archived, but will still be visible, including their run history.

If you need to cancel all runs prior to completion, read our cancellation guide.

How to archive an app

  1. Navigate to the app you want to archive. You will find an “Archive” button at the top-right corner of the page.
Inngest Cloud screen with archive app button
  1. Confirm that you want to archive the app by clicking "Yes".
Inngest Cloud screen with archived app confirmation modal
  1. Your app is now archived. 🎉
Inngest Cloud screen with one app archived

In the image below, you can see how archived apps look like in Inngest Cloud:

Inngest Cloud screen with archived apps

Troubleshooting

Why is my app syncing to the wrong environment?

  • Apps are synced to one environment. The INNGEST_SIGNING_KEY ensures that your app is synced within the correct Inngest environment. Verify that you assigned your signing key to the right INNGEST_SIGNING_KEY environment variable in your hosting provider or .env file locally.

Why do I have duplicated apps?

Why is my sync inside unattached syncs?

  • Failures in automatic syncs may not be immediately visible. In such cases, an unattached sync (a sync without an app) containing the failure message is created.

Why don’t I see my sync in the sync list?

If you're experiencing difficulties with syncing and cannot locate your sync in the sync list, consider the following scenarios:

  1. Different App ID:
  • If you resync the app after modifying the app ID, a new app is created, not a new sync within the existing app.
  • Solution: Confirm the creation of a new app when changing the app ID.
  1. Syncing Errors:
  • Manual Syncs and Manual Resyncs:
    • Sync failures during manual operations are immediately displayed, preventing the creation of a new sync. The image below shows an example of an error while manually syncing: Inngest Cloud screen with app error while syncing
    • Solution: Review the displayed error message and address the syncing issue accordingly.
  • Automatic Syncs (such as Vercel Integration):
    • Failures in automatic syncs may not be immediately visible. In such cases, an unattached sync (a sync without an app) containing the failure message is created.

      Inngest Cloud screen with app sync error
    • Solution: Check for unattached syncs and address the issues outlined in the failure message. The image below shows the location of unattached syncs in Inngest Cloud:

      Inngest Cloud screen with unattached syncs