coollabsio/coolify · error · RuntimeException

Passphrase is required to encrypt the bundle.

Error message

Passphrase is required to encrypt the bundle.

What it means

Error "Passphrase is required to encrypt the bundle." thrown in coollabsio/coolify.

Source

Thrown at app/Livewire/Server/Transfer.php:119

    {
        $this->ensureDevelopmentAvailability();

        try {
            $this->authorize('view', $this->server);
            if ($this->isLocalhost) {
                throw new \RuntimeException('The Coolify host (localhost) cannot be transferred.');
            }

            $bundle = $exporter->export($this->server, includeSensitive: true);
            $this->exportId = data_get($bundle, 'export_id');
            $this->lastWarnings = array_values((array) data_get($bundle, 'warnings', []));
            $this->lastResultJson = null;

            $payload = $bundle;
            $fileName = 'server-transfer-'.$this->server->uuid.'.json';
            if ($this->encryptBundle) {
                if (blank($this->passphrase)) {
                    throw new \RuntimeException('Passphrase is required to encrypt the bundle.');
                }
                $payload = ServerTransferBundle::encryptWithPassphrase($bundle, $this->passphrase);
                $fileName = 'server-transfer-'.$this->server->uuid.'.encrypted.json';
            }

            $json = json_encode($payload, JSON_PRETTY_PRINT | JSON_UNESCAPED_SLASHES);
            if ($json === false) {
                throw new \RuntimeException('Failed to encode transfer bundle.');
            }

            $this->dispatch('success', 'Transfer bundle ready for download.');

            return response()->streamDownload(function () use ($json) {
                echo $json;
            }, $fileName, [
                'Content-Type' => 'application/json',
            ]);
        } catch (Throwable $e) {

View on GitHub (pinned to 70b9acc424)

When it happens

Trigger: Thrown at app/Livewire/Server/Transfer.php:119 when the library encounters an invalid state.

Common situations: See trigger scenarios.


AI-assisted analysis of coollabsio/coolify@70b9acc424 (2026-08-17). Data as JSON: /api/errors/d01a5f1ed04c5e9a. Report an issue: GitHub.