HeyPuter/puter · error · HttpError

app_name_already_in_use

app_name_already_in_use

Error message

Failed to dedupe app name

What it means

Error "Failed to dedupe app name" thrown in HeyPuter/puter.

Source

Thrown at src/backend/drivers/apps/AppDriver.js:237

        });
        if (joinedApp) {
            return joinedApp;
        }
        await this.#ensureIndexUrlNotAlreadyInUse({
            indexUrl: fields.index_url,
        });

        // Name conflict handling
        if (await this.appStore.existsByName(fields.name)) {
            if (options?.dedupe_name) {
                let candidate;
                let i = 0;
                do {
                    const randString = Math.random().toString(36).slice(2, 6);
                    candidate = `${fields.name}-${randString}`;

                    if (i >= 3)
                        throw new HttpError(400, 'Failed to dedupe app name', {
                            legacyCode: 'app_name_already_in_use',
                        });
                    i++;
                } while (await this.appStore.existsByName(candidate));
                fields.name = candidate;
            } else {
                throw new HttpError(
                    400,
                    'An app with this name already exists',
                    { legacyCode: 'app_name_already_in_use' },
                );
            }
        }

        const filetypes = fields.filetype_associations;
        delete fields.filetype_associations;

        // Ownership is passed as a separate, privileged arg — the store

View on GitHub (pinned to 908ec23eda)

Solutions

1. Retry with a different app name.
2. Check for conflicting existing apps that block name deduplication.

When it happens

Trigger: Thrown at src/backend/drivers/apps/AppDriver.js:237 when the library encounters an invalid state.

Common situations: See trigger scenarios.

AI-assisted analysis of HeyPuter/puter@908ec23eda (2026-08-12). Data as JSON: /api/errors/ac74285f4c008d06. Report an issue: GitHub.