Dienstag, 5. Mai 2015

BackupGoo Command-Line for Domains

Over the last months we have made substantial changes to BackupGoo's command-line version. With this Blog entry we would like show you how to use it with your Google Apps Domain.


There are 4 scripts to BackupGoo's command-line with which you can control everything and start your backup. The command-line package from our website contains those 4 scripts for Unix systems ending in .sh and Windows systems ending in .bat. Depending on the system you work on, you can get rid of the scripts you don't need. All you need to do is to extract the archive and run a script.

This is your entry point for setting up a domain. Besides adding domains you can delete domains or list all your registered domains. A full help list with all options can be printed using the script without any parameters.

That is the central place for changing all your options in BackupGoo. Additionally you can set up the authentication system for your domain. Options include turning on or off the backup of different Google services, changing the backup directory, setting the backup of multiple user in parallel, turning on or off the backup of special Gmail labels or Drive folders and many more. A full help can be printed using backupgoo-setup without any parameters.

Call this script without any parameters to start the backup. Two minor parameter options allow for selecting a specific domain or accounts file to start the backup with a fraction of your domains and accounts (if you have created such files). Otherwise the backup will start with all registered domains.

The accounts script allows for manually adding or removing accounts for your domains. Normally BackupGoo will fetch all your accounts automatically once you register a domain, but here you can do that manually. Besides removing and adding accounts, this script allows for listing all accounts. A help menu can be printed with the -h parameter.

Setting up a Domain

Simply call:
backupgoo-domains -a -d

After that, if you are setting up a domain for the first time, BackupGoo will show you a message, that there is no domain authentication system in place:

For the domain authentication you only need 2 files. You can get them following our guideline:

and provide them with the setup script:
backupgoo-setup -ds /path/to/clients/secrets/ -pk /path/to/pk12/file

BackupGoo will then ask you to grant BackupGoo access to your domain:

after adding the scopes in your domain security page proceed. BackupGoo will fetch all your domain accounts automatically and you are done.

Changing Options

is the script for all options. We will explain some of them here:

backupgoo-setup -p 10
Will let BackupGoo backup 10 of your domain accounts in parallel. This is important as it speeds up the backup time and makes full use of your bandwidth. If you have enough free memory you can also raise the number.

backupgoo-setup -am true
This will activate the backup of Gmail's "All Mail" label. This is important because not all mails are stored under labels and you will make sure all emails are being backed up.

backupgoo-setup -d /path/to/new/directory
The -d option will change your backup directory path (i.e. you want to save to an external or network drive or Cloud storage hung into your system)

backupgoo-setup -sh true
That's a Drive Service option turning on the backup of Drive files that are shared with a domain account. If a user shares a document with 10 people in the domain, for all 10 people this document will be backed up. If this is turned off, only the owner will have backups of that document.

backupgoo-setup -key <license>
With this option you can enter a BackupGoo license key, e.g. after a purchase or your test license for extended testing.

backupgoo-setup -a false
This will turn off (or on) the automatic fetching of domain users.

Starting the Backup

Simply call backupgoo-backup without any parameters.

Adding or Removing Domain Users Manually

BackupGoo will automatically remove all domain users, that are deleted from your Google Domain. But there is an option to turn of the automatic user fetching for domain users. If the automatic user fetching is off, you would need to add domain users manually. To do that you simply call:

backupgoo-accounts -a ...

In the same way you can remove users from any domain, but with the  -r parameter:

backupgoo-accounts -r ...

With backupgoo-accounts -l you can list all accounts currently stored.

Montag, 4. Mai 2015

BackupGoo 5.1.9 New Domain User System

Hello everyone.

We have just released BackupGoo 5.1.9 fixing the most current problem with fetching users from domains. We have switched our APIs and Account Models.

We recommend all users to update to the new version by either using the "Help" menu and "Check for updates" in BackupGoos UI version or by downloading the newest Command-Line version from our download site:

We would very much like to apologize for the service disruption in the last two weeks. We will make sure that this is never going to happen again.

BackupGoo will tell you automatically if you need to do anything to work with the new API.

In the UI two windows should show. The first window informs you to change the scopes in your Google Domain Security Panel and looks like this:

The second window asks you to activate the Admin SDK in your API project and looks like this:

For the command-line-version the message to change your API scopes in the Google Domain Security page looks like this:

And the message to activate the Admin SDK will look like this:

German Version


Wir haben soeben BackupGoo 5.1.9 veröffentlicht. Damit beheben wir das aktuelle Problem neue Nutzer Ihrer Domain zu laden. Wir haben dafür eine API umgestellt und unsere Modelle angepasst.

Wir empfehlen allen Nutzern den Wechsel auf die neue Version. Dies kann in der graphischen Version passieren unter "Help" und dann "Check for Updates" oder durch das Herunterladen der neusten Kommandozeilen-Version von unserer Download Seite:

Wir möchten uns vielmals für die Dienst-Unterbrechung in der letzten Zeit entschuldigen. Wir werden sicherstellen, dass dies nie wieder geschieht.

Um mit der neuen API zu arbeiten wird BackupGoo Ihnen automatisch anzeigen was zu tun ist.
In der graphischen Version werden 2 Fenster angezeigt. Ein Fenster wird Ihnen zeigen, dass Sie Ihre API Bereiche in Ihrer Google Domain Sicherheitsseite ändern müssen:

Das zweite Fenster wird Ihnen sagen, dass Sie das Admin SDK in Ihrem API Projekt aktivieren müssen:

In der Kommandozeilen-Version sieht die Nachricht zum Ändern der API Bereiche so aus:

Und für die Aktivierung des Admin SDK so:

Dienstag, 24. März 2015

BackupGoo 5.1.8 - Easier Setup and important Fixes

It's been a long time,

but we've released a brand new version with lots of improvements on the account setup and important bug fixes. Here are the changes:


  • Option for internal Domain authentication - no need for an API project.
  • Users with huge Domains are having their authentication managed by us.
  • Single account authentication is now managed by us - easier setup process.
  • Drive Service will not repeat a problematic file in the same session.
  • Command-line version comes with options to turn on/off special Gmail folders.
  • Check before each backup if the backup directory is reachable.
  • Better information and warning dialogs in the UI and command-line version during the account setup process.
  • Single account setup is now better guided with more information and stop options.
  • Drive Service uses less memory and starts faster, especially with lots of files.


  • Fixed Nullpointer error for some scenarios in the Gmail service.
  • Fixed Drive Service issue where the download is closed.

German Version

Neue Funktionen

  • Option einer internen Domain Authentifizierung - kein API Projekt notwendig.
  • Nutzer mit großen Domains können Ihre Authentifizierung durch uns verwalten lassen.
  • Einzel-Konten Authentifizierung wird von uns übernommen - bequemerer Einrichtungs-Prozess.
  • Drive Dienst wiederholt problematische Datei nicht in der gleichen Sitzung.
  • Kommando-Zeilen-Version kommt mit neuen Optionen, um besondere Gmail Ordner an- oder auszuschalten.
  • Neue Überprüfung vor jeder Sicherung, ob das Sicherungs-Verzeichnis erreichbar ist.
  • Einzel-Konten Einrichtung ist jetzt einfacherer mit mehr Dialogen und Optionen jederzeit abzubrechen.
  • Der Drive Dienst verbraucht jetzt weniger Arbeitsspeicher und startet schneller vor allem bei sehr vielen Dateien.


  • Nullpointer im Gmail Dienst behoben, der manchmal auftauchen kann.
  • Drive Dienst Problem behoben, bei dem der Download manchmal unterbrochen wird.

Montag, 22. September 2014

BackupGoo 5.1.7

Hello everyone.

We just released a new version of BackupGoo, 5.1.7.

It took us longer than expected to get this version out, but we did a lot of testing and included a lot things behind the scenes to make sure BackupGoo is even better tested in the future.

We recommend to update to this version immediately!
Enough of the intro, let's get to the core of the update - as always in a clear list:


  • Domain authentication adapted to Google's changes
  • Retry mechanism for the Calendar Service upon problems.
  • Calendar-specific retry and skip mechanism for the Calendar Service.
  • Calendar service backs up a calendar only if it has been modified.
  • Retry mechanism for the Contacts Service upon problems.
  • Drive option to download the Drive Trash.
  • Version display on the main window's top.


  • Fixed infinite loop during errors in the Gmail service.

Deutsche Version

Neue Funktionen

  • Domain Authentifizierung angepasst an Googles Änderungen
  • Wiederhol-Mechanismus für den Kalender Dienst bei Fehlern.
  • Kalender-spezifischer Wiederhol-Mechanismus für den Kalender Dienst.
  • Sicherung eines Kalenders nur wenn er verändert wurde.
  • Wiederhol-Mechanismus für den Kontakte Dienst bei Fehlern.
  • Drive Funktion um den Drive Papierkorb zu sichern.
  • Versions-Anzeige im Hauptfenster im oberen Teil.


  • Behobene Endlosschleife im Gmail Dienst bei Fehlern. 

Donnerstag, 13. März 2014

BackupGoo 5.1.6

Hi there.

A couple of hours ago we released a new version of BackupGoo (5.1.6). This version is another step on the way to a more robust BackupGoo. We fixed some high-priority issues, along with suitable features. Again, thanks to all you people reporting problems. We highly appreciate that.

Following the details:


  • Escape all control characters in file and folder names.
  • Escaping spaces at the beginning and end of files and folders.
  • Fixed wrong headless mode for command-line.


  • Label-specific Gmail Service retry mechanism.
  • File-specific Drive Service retry mechnism.

Deutsche Version


  • Ersetzen von allen Kontrollzeichen in Datei und Verzeichnisnamen.
  • Ersetzen von Leerzeichen am Anfang und Ende von Datei und Verzechnissen.
  • Falscher headless mode für die Kommandozeilen Version behoben.

Neue Funktionen

  • Label-genaues Wiederhol-Mechanismus für den Gmail Dienst.
  • Datei-genauer Wiederhol-Mechanismus für den Drive Dienst.

Donnerstag, 30. Januar 2014

BackupGoo 5.1.5

After releasing our bigger update 5.1.4, we realized there were still some things that caused BackupGoo to stop the backup. Thanks to all the users out there for the valuable feedback, that helped us fix the problems.

At the end of last week we therefore released a bugfix version. The current BackupGoo version is now 5.1.5 . We recommend to update BackupGoo using the "Help" -> "Check for Updates" functionality in the UI or the download of new scripts from our download section.

Following the changes:
  • Fixed wrong counter in Gmail Service if there are no new mails in a folder.
  • Fixed wrong escaping of Asterisk in Email subjects.
  • Fixed wrong file paths for Drive files without extensions.

Deutsche Version

  • Falscher Zähler für den Gmail Dienst behoben bei Ordnern ohne neue E-Mails.
  • Fehlerhaftes Umformen von Asterisk in E-Mail Betreffs behoben.
  • Fehlerhafte Pfadzuweisung bei Drive Dateien ohne Endung behoben.

Mittwoch, 15. Januar 2014

BackupGoo Release 5.1.4

The BackupGoo Team is very pleased and proud to present this release.

BackupGoo 5.1.4 is now live and ready to update to, or to download.

We know it took us some time to get this release done, but we have included many fixes and new features. Enough of the talk. We let the facts speak for themselves.
As usual, feedback to is very welcome. Including problems and new feature requests. Thank you.

BackupGoo 5.1.4


  • Fixed Bug in user interface where logs could not be opened by unsupported desktops like Ubuntu.
  • Fixed Bug in user interface where feedback link could not be opened by unsupported desktops like Ubuntu.
  • Fixed Bug in user interface where backup location was not saved from the start up dialog.
  • Fixed Bug in backups where ellipsis in names caused BackupGoo to hang
  • Fixed Bug in domain authentication system where missing key file caused authorization to hang.
  • Typo corrections in user interface.
  • Fixed Bug in Calendar Service with invalid emails.
  • Fixed Bug in Calendar Service with timeouts and no reconnects.
  • Fixed Bug in Drive Service where problematic files were not skipped.
  • Fixed Bug in Drive Service with Forms that caused the backup to hang.
  • Fixed wrong Drive file counter in UI.
  • Fixed wrong Gmail counter in UI.
  • Fixed Bug in BackupGoo website with wrong re-direct to PayPal checkout page.


  • Full character support for folder and file names in your backup.
  • Completely new authentication system with one-time setup.
  • New logging system. More communicative. Bilingual. Configurable via options.
  • More communicative scheduler.
  • Scheduler for the command line version. Activate via setup script.
  • Drive Service now tracks versions of uploaded files such as Office files, images, etc.
  • Less memory usage.
  • Automatic removal of deleted or suspended domain accounts.
  • Automatically add new domain users as an option.
  • New command line domain administration via the backupgoo-domains script.
  • Domains removable via the backupgoo-domains script.
  • New command line accounts administraion via the backupgoo-accounts script.

Deutsche Version


  • Fehler in der graphischen Oberfläche behoben, bei dem die Log Dateien unter nicht unterstützten Desktops nicht geöffnet werden konnten.
  • Fehler in der graphischen Oberfläche behoben, bei dem die Weiterleitung zum Feedback System bei nicht unterstützten Desktops nicht funktionierte.
  • Fehler in der graphischen Oberfläche behoben, bei dem das Sicherungs-Verzeichnis aus dem Start Dialog nicht übernommen wurde.
  • Fehler behoben, bei dem drei Punkte am Ende von Datei oder Ordner Namen BackupGoo aufhängte.
  • Fehler im Autorisierungssystem behoben, bei dem die Verschiebung der Schlüssel Datei das Autorisierungssystem aufhing.
  • Schreibfehler in allen Schnittstellen behoben.
  • Fehler im Kalender Service behoben, bei dem ungültige Mail Adressen die Sicherung aufhing.
  • Fehler im Kalender Service behoben, bei dem Verbindungsprobleme und fehlendes Wiederverbinden die Sicherung stoppte.
  • Fehler im Drive Service behoben, bei dem Google Forms die Sicherung aufhing.
  • Fehler im Drive Service behoben, bei dem problematische Dateien die Sicherungen aufhingen.
  • Fehlerhafter Zähler in der graphischen Oberfläche für Drive Dateien behoben.
  • Fehlerhafter Zähler in der graphischen Oberfläche für Mails behoben.
  • Fehler in der Website behoben, bei dem zu einer falschen PayPal Seite weitergeleitet wurde.

Neue Funktionen

  • Volle Zeichenunterstützung bei Datei und Ordner Namen.
  • Neues aussagekräftigeres, bilinguales Log System, das in den Optionen konfigurierbar ist.
  • Völlig neues Autorisierungssystem mit einer einmaliger Einrichtung.
  • Zeitsteuerungssystem in der Kommandozeilen Version über das setup Skript.
  • Drive Service hält nun Versionen von hochgeladenen Drive Dateien vor.
  • Weniger Speicherverbrauch durch BackupGoo.
  • Automatisches Löschen von gelöschten Domain Konten.
  • Automatisches, optionales Hinzufügen von neuen Domain Konten.
  • Neue Kommandozeilen Domain Administration mittels des backupgoo-domains Skript.
  • Domains entfernbar über backupgoo-domains Kommandozeilen Skript.
  • Neue Konto Administration mittels des backupgoo-accounts Skript.