Liking cljdoc? Tell your friends :D


A Clojure library to back up your Firestore to Google Storage

Clojure CI codecov

Clojars Project


Environment variables:

  1. GOOGLE_CLOUD_PROJECT contains the name of the project containing both firestore and the cloud storage
  2. GOOGLE_APPLICATION_CREDENTIALS contains the .json credential for the service account being used.

magma uses alekcz/google-credentials to load Google Credentials from the GOOGLE_APPLICATION_CREDENTIALS

[alekcz/magma "1.0.0"]

(require '[magma.core :as magma])

;by default the root is called magma-<project-id>. 
;The bucket is called named after the root



(magma/backup-firestore "gs://bucket-name")

(magma/restore-firestore "gs://bucket-name/yyyy-MM-ddTHH:mm:ss.SSS")

(magma/roll-back-firestore) ;for your safety magma waits 60 seconds before starting the roll back

(magma/deleting-your-backups-is-a-really-bad-idea "yyyy-MM-ddTHH:mm:ss_SSS")

;Renaming the root
(magma/rename-root "namespace")
; The root is now magma-namespace-<project-id>
; This function primarily exists to enable testing

I'm currently using magma to backup my DB just before I deploy a change to my production API.


Copyright © 2020 Alexander Oloo

This program and the accompanying materials are made available under the terms of the Eclipse Public License 2.0 which is available at

This Source Code may also be made available under the following Secondary Licenses when the conditions for such availability set forth in the Eclipse Public License, v. 2.0 are satisfied: GNU General Public License as published by the Free Software Foundation, either version 2 of the License, or (at your option) any later version, with the GNU Classpath Exception which is available at

Can you improve this documentation?Edit on GitHub

cljdoc is a website building & hosting documentation for Clojure/Script libraries

× close