Skip to main content
Version: 3.0.0-beta

Self-Hosted Deployment

Deployment to FireCMS Cloud

FireCMS is unique among CMSs in that it allows to upload custom code to its Cloud version. This is a very advanced feature enables you to tailor the CMS according to your requirements.

The code is bundled and compiled using module federation and vite. This means that you can use any npm package you want to build your CMS. The bundle will not include any of the dependencies that are already included in FireCMS, so you can use any version of any package you want.

Deploy your code to FireCMS Cloud, with a single command, and it will be served from there:

yarn deploy

The benefit of this approach is that you can use any npm package you want, and you can use the latest version of FireCMS without having to manually update your code.


The FireCMS CLI is a tool that allows you to deploy your CMS to FireCMS Cloud with a single command. In your project, you should have firecms as a dev dependency. This package was previously @firecms/cli.

The available commands are:

firecms login
firecms logout


firecms deploy --project=your-project-id

Deployment to Firebase Hosting


You can only deploy outside FireCMS Cloud if you have a PRO plan.

If you would like to deploy your CMS to Firebase Hosting, you need to enable it first in the Hosting tab of your Firebase project.

You will need to init Firebase, either with an existing project or a new one:

firebase init

You don't need to enable any of the services, besides Firebase Hosting if you would like to deploy it there.

You can link the Firebase hosting site to the webapp that you have created in order to get your Firebase config.

In order to make everything work as expected, you need to setup Firebase Hosting redirects to work as a SPA. Your firebase.json should look similar to this (remember to replace [YOUR_SITE_HERE]).

"hosting": {
"site": "[YOUR_SITE_HERE]",
"public": "dist",
"ignore": [
"rewrites": [
"source": "**",
"destination": "/index.html"

Then simply run:

yarn run build && firebase deploy --only hosting

to deploy.

Sign up to our newsletter to get the latest news and updates. No spam!