puter.hosting.update()

Websites Puter Apps Node.js Workers

Updates a subdomain to point to a new directory.

Syntax

puter.hosting.update(subdomain, dirPath)

Parameters

subdomain (String) (required)

A string containing the name of the subdomain you want to update.

dirPath (String) (required)

A string containing the path to the directory you want to serve.

Return value

A Promise that will resolve to a Subdomain object when the subdomain has been updated. If a subdomain with the given name does not exist, the promise will be rejected with an error. If the path does not exist, the promise will be rejected with an error.

Examples

Update a subdomain to point to a new directory

<html>
<body>
    <script src="https://js.puter.com/v2/"></script>
    <script>
        (async () => {
            // (1) Create a random website
            let subdomain = puter.randName();
            const site = await puter.hosting.create(subdomain, '.')
            puter.print(`Website hosted at: ${site.subdomain}.puter.site<br>`);

            // (2) Create a random directory
            let dirName = puter.randName();
            let dir = await puter.fs.mkdir(dirName)
            puter.print(`Created directory "${dir.path}"<br>`);

            // (3) Update the site with the new random directory
            await puter.hosting.update(subdomain, dirName)
            puter.print(`Changed subdomain's root directory to "${dir.path}"<br>`);

            // (4) Delete the app (cleanup)
            await puter.hosting.delete(subdomain)
        })();
    </script>
</body>
</html>