Skip to main content

npx remotion cloudrun sites

Cloud Run is in Alpha, which means APIs may change in any version and documentation is not yet finished. See the changelog to stay up to date with breaking changes.

The npx remotion cloudrun sites command allows to create, view and delete Remotion projects in your Cloud Storage bucket.

create

npx remotion cloudrun sites create src/index.ts
npx remotion cloudrun sites create src/index.ts

Bundle and upload a Remotion video to a Cloud Storage bucket.

The result will be a URL such as https://storage.googleapis.com/remotioncloudrun-12345/sites/mySite123/index.html.

note

If you make changes locally, you need to redeploy the site. Use --site-name to overwrite an existing site.

You can use this "Serve URL" to render a video on Remotion Cloud Run using:

If you are rendering on Cloud Run, you can also pass the site Name (in this case mySite123) as an abbreviation.

Example output
(1/3) [====================] Bundled video 3975ms
(2/3) [====================] Created bucket 457ms
(3/3) [====================] Uploaded to GCP Storage Bucket 25118ms

Deployed to GCP Cloud Storage!

Site: mySite123
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/mySite123/index.html

--region

The GCP region to select. The service accessing the site should also be in this same region to minimise latency.

--site-name

Uploads the project to a specific directory and returns a deterministic URL. If a site already existed under this name, in the same region, it will be overwritten. Can only contain the following characters: 0-9, a-z, A-Z, -, !, _, ., *, ', (, )

npx remotion cloudrun sites create src/index.ts --site-name=another-site
npx remotion cloudrun sites create src/index.ts --site-name=another-site
Example output
(1/3) [====================] Bundled video 3975ms
(2/3) [====================] Created bucket 457ms
(3/3) [====================] Uploaded to Cloud Storage 25118ms

Deployed to GCP Cloud Storage!

Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html

ls

npx remotion cloudrun sites ls
npx remotion cloudrun sites ls

Get a list of sites. The URL that is printed can be passed to the render command to render a video.

Example output
2 sites in us-east1, in the remotion-example project.

Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html

Site: test-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/test-site/index.html

--region

The GCP region to list sites from.

--all-regions,

Ignores region, returning sites across all regions for the project.

npx remotion cloudrun sites ls --all-regions
npx remotion cloudrun sites ls --all-regions
Example output
3 sites in all regions, in the remotion-example project.

Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html

Site: test-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/test-site/index.html

Site: central-site
Bucket: remotioncloudrun-abcdefgh
Region: us-central1
Serve Url: https://storage.googleapis.com/remotioncloudrun-abcdefgh/sites/central-site/index.html

--quiet, -q

Returns only a list of space-separated sites.

npx remotion cloudrun sites ls -q
npx remotion cloudrun sites ls -q
Example output
another-site test-site central-site

rm

Removes a site (or multiple) from Cloud Storage by it's ID.

bash
npx remotion cloudrun sites rm central-site
npx remotion cloudrun sites rm central-site another-site # multiple at once
bash
npx remotion cloudrun sites rm central-site
npx remotion cloudrun sites rm central-site another-site # multiple at once
Example output
Site:            central-site
Bucket: remotioncloudrun-abcdefgh
Region: us-central1
Serve Url: https://storage.googleapis.com/remotioncloudrun-abcdefgh/sites/central-site/index.html

Delete? (Y/n) Y
Deleted site central-site from bucket remotioncloudrun-abcdefgh.

--region

The GCP region to remove sites from.

note

The rm command does not support the --all-regions flag, as it is possible to have the same site name in multiple regions. This makes it difficult to remove multiple site-names from multiple regions.

--yes, -y

Removes a site (or multiple) without asking for confirmation.

npx remotion cloudrun sites rm central-site -y
npx remotion cloudrun sites rm central-site -y

rmall

Remove all sites in the selected GCP project.

bash
npx remotion cloudrun sites rmall
bash
npx remotion cloudrun sites rmall
Example output
Retrieving sites in us-east1.

Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html

Delete? (Y/n) n
Skipping site - another-site.


Site: test-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/test-site/index.html

Delete? (Y/n) n
Skipping site - test-site.

--region

The GCP region to remove all sites from.

--all-regions,

Ignores region, removing sites across all regions for the project.

npx remotion cloudrun sites rmall --all-regions
npx remotion cloudrun sites rmall --all-regions
Example output
Retrieving sites in all regions.

Site: another-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/another-site/index.html

Delete? (Y/n) n
Skipping site - another-site.


Site: test-site
Bucket: remotioncloudrun-12345
Region: us-east1
Serve Url: https://storage.googleapis.com/remotioncloudrun-12345/sites/test-site/index.html

Delete? (Y/n) n
Skipping site - test-site.


Site: central-site
Bucket: remotioncloudrun-abcdefgh
Region: us-central1
Serve Url: https://storage.googleapis.com/remotioncloudrun-abcdefgh/sites/central-site/index.html

Delete? (Y/n) n
Skipping site - central-site.

--yes, -y

Removes all sites without asking for confirmation.

npx remotion cloudrun sites rmall -y
npx remotion cloudrun sites rmall -y