FileBunker FAQ


1. What is FileBunker?
2. How do I get a GMail account?
3. What happens if I run out of space in my GMail account?
4. Can I use my GMail account while also using it as a FileBunker repository?
5. What do FileBunker backup email messages look like in my GMail account?
6. Will FileBunker backup emails clutter my GMail inbox?
7. Are my files secure?
8. Why do I need to establish a 'FileBunker' password?
9. What happens if I change my password after backing up files? Can I restore those files even though they were encrypted with the old password?
10. Whats an SMTP server and why do I need to specify it for FileBunker to work?
11. Why does it take so long to backup files?
12. What kind of compression ratios can I expect?
13. Why isn't FileBunker backing up the files in my selection?
14. How does FileBunker know when to backup a file?
15. I just backed up a file and I can't restore it. What gives?
16. Can I run FileBunker automatically as an NT Service?
17. What happens if GMail changes in a way that 'breaks' FileBunker? Can I still get my files?
18. Can I retrieve my files from other computers?
19. How will my ISP feel about me emailing thousands of files to my GMail account as part of a major backup?
20. Is there a command line version of FileBunker?
21. Why does FileBunker once in awhile ask me to type in strange characters from an image?
22. Why can't I see D:\?
23. What is Java and where do I get it?
24. How do I run FileBunker on MacOSX?
25. Can I use FileBunker with a Yahoo! Mail Plus account?


What is FileBunker?

FileBunker is a file backup application which uses one or more GMail accounts as its backup repository. Because each GMail account supplies 1000 megabytes of storage, it serves as an excellent facility for this purpose.


How do I get a GMail account?

Currently GMail accounts are by "invitation" only, which means you need to know someone who has a GMail account that can invite you. Ask that person to login to their GMail account and look for the "Invite a friend to join Gmail!" link. Presumably in the near future these accounts will be available to anyone similar to Yahoo Mail or Hotmail.


What happens if I run out of space in my GMail account?

FileBunker automatically compresses your files so they will occupy less space in your GMail account. If your account becomes full, FileBunker will automatically delete messages that represent files that have multiple versions already backed up. FileBunker will never delete the last version of a file stored in your GMail account. You can also acquire multiple GMail accounts, and configure FileBunker with all of them. It will automatically "overflow" from a full GMail account to one that has space.


Can I use my GMail account while also using it as a FileBunker repository?

Sure. FileBunker accesses your GMail account to see how much space is available, and will only backup files to that account which can fit in the available space.


What do FileBunker backup email messages look like in my GMail account?

FileBunker backup email messages have a subject line like:
FileBunker: AAAA/ulSTECt9YxEAAAAAQ [0]


Will FileBunker backup emails clutter my GMail inbox?

Generally speaking, no. When FileBunker runs it periodically tries to archive these messages for you so you never see them. At times you may see some backup emails in your inbox. If so, just select those messages and Archive them.


Are my files secure?

FileBunker automatically encrypts your files before sending them using the password you provide in the FileBunker configuration dialog. This password is stored securely on your computer and is never sent to your GMail account or anywhere else. The passwords you specify for your GMail accounts are also stored securely.


Why do I need to establish a 'FileBunker' password?

FileBunker uses this password to securely encrypt your files before sending them to your GMail account. See the FAQ Are my files secure?


What happens if I change my password after backing up files? Can I restore those files even though they were encrypted with the old password?

FileBunker remembers all of your passwords (and when they were in effect) so that old files can be retrieved and decoded with the correct one. All of these passwords are stored securely.


Whats an SMTP server and why do I need to specify it for FileBunker to work?

An SMTP server is a computer that can send emails. This is necessary so that FileBunker can email your files to your GMail account. Usually your SMTP server can be retrieved from the account configuration in your Email application. For instance, in Outlook, check Tools->Account->Properties->Servers.


Why does it take so long to backup files?

Remember that over a DSL connection, upload speeds are usually around 25Kb per second or less. If you are backing up 100Mb, that would take roughly 30 minutes assumming a 50% compression ratio. This is usually only an inconvenience during your first backup, when all files need to be sent. Subsequent backups only send files that have changed since the last backup (a so called incremental backup), and if performed regularly, the number of files that are sent is usually small.


What kind of compression ratios can I expect?

FileBunker uses gzip, which achieves varying compression ratios depending on the files being compressed. For instance plain text files will compress much better than mp3 files. The author has experienced ratios of 50% over a home directory which had a combination of many different types of files.


Why isn't FileBunker backing up the files in my selection?

Most likely the files were backed up previously and have not changed. FileBunker only performs so called "incremental" backups, meaning only files that have changed since the last backup are considered in need of a backup.


How does FileBunker know when to backup a file?

FileBunker backs up a file only if it has never been backed up before, or if the file has changed since its last backup. It detects changes in a file by computing an MD5 checksum, so it will not backup files just because the timestamp has been changed. Also, these MD5 checksums are used to avoid backing up multiple copies of the same file. So if a file exists with two different names and/or in two different directories, only one copy will be sent to your gmail account. Or, put another way, before a file is backed up, FileBunker checks to see if you have ever backed up any file with the same contents, and if so, there is no need to send the file.


I just backed up a file and I can't restore it. What gives?

Files can sometimes take a few minutes or even a few hours to arrive in your GMail account after being sent during a backup. The author has seen files take as long as 12 hours to arrive, so be patient.


Can I run FileBunker automatically as an NT Service?

Currently there is no built in support for performing automated backups as an NT service. With some work you can get the effect by creating your own NT service that invokes the command line version of FileBunker (see Is there a command line version of FileBunker?).


What happens if GMail changes in a way that 'breaks' FileBunker? Can I still get my files?

Yes, although it is currently inconvenient. Currently this involves running the command line version of FileBunker (see Is there a command line version of FileBunker?). If you need to decrypt a file manually, first find the globally unique identifier (guid) for that file. This can be found by dumping the database of files stored in your backup repository using the dumpDatabase operation of the command line FileBunker. Visual inspection of the output of the dump should allow you to track down the guid (e.g. AAAA/ulSTECt9YxEAAAAAQ). You can now manually log into your GMail account and search for that file. Download the attachment and save it locally. Note if the file is larger than 10Mb, then you will need to download each part and concatenate them together yourself using a command line utility like cat. Now you can run the command line FileBunker with the decrypt operation to recover the file. See the command line FileBunker usage for more information on the dumpDatabase and decrypt operations.


Can I retrieve my files from other computers?

You can only do this in a manual way as described in the FAQ What happens if GMail changes in a way that 'breaks' FileBunker? Can I still get my files?. In a future version of FileBunker you will be able to install FileBunker on a new machine, configure it to point at your existing GMail accounts, and it will automatically reconstruct its understanding of what it has backed up to those accounts, allowing you to recover files immediately.


How will my ISP feel about me emailing thousands of files to my GMail account as part of a major backup?

In some cases, your ISP may refuse outgoing messages (by literally blocking access to their SMTP server) if it has detected that you are sending inhuman volumes of mail. This is a side effect of their admirable attempt to stop spam. The author had this experience with Earthlink, but remedied it by using their authenticated SMTP server, which does not have such restrictions. In this situation, a long backup went for about 20 minutes (~ 1000 files), and then failed with an error (handled gracefully in FileBunker with an error dialog). For about the next hour, all outgoing mail (whether from FileBunker or from an Email client) was broken. If you find yourself in this situation, contact your ISP to explore remedies such as authenticated SMTP.


Is there a command line version of FileBunker?

Yes there is. You can run the java class com.toubassi.filebunker.commandline.FileBunker with the "-usage" argument to get more information on its functionality. Make sure to specify all Jar files in the FileBunker/Resources/lib directory on your classpath, and make sure to run with Java 1.4.2_05 or later.


Why does FileBunker once in awhile ask me to type in strange characters from an image?

Google has introduced an additional authentication procedure which is presented to users infrequently. This procedure requires the user to look at an image with warped characters in it, and type in what they see. When FileBunker needs to login to your GMail account, if this process is needed, you will be presented with the image and asked to type in the characters in it. Again, this should be an infrequent event.


Why can't I see D:\?

On Windows, by default only C:\ is shown in the backup explorer. You must manually tell FileBunker to show other drives by going to the File->Configuration, and selecting the appropriate checkboxes in the "Show Drives" field. This is a workaround for a problem in Java where drives that are not present trigger an "Abort/Retry/Ignore" dialog. The author welcomes input on how to workaround this problem.


What is Java and where do I get it?

Java is a cross platform software technology from Sun microsystems that is available for free. FileBunker specifically requires version 1.4.2_05 or later. Visit http://java.sun.com/j2se/1.4.2/download.html and download the "J2SE v 1.4.2_05 JRE" (Java 2 Standard Edition version 1.4.2_05 Java Runtime Environment) or later. If this link doesn't work, visit http://java.sun.com/downloads/index.html.


How do I run FileBunker on MacOSX?

FileBunker has not yet been tested on Mac OSX. Those who are technically inclined and willing to experiment should start with the linux release, and then augment the FileBunker/Resources/lib with appropriate libraries/jars from the Mac OSX version of eclipse (visit http://download.eclipse.org). You will also need to modify Resources/FileBunker.conf to include those libraries/jars.


Can I use FileBunker with a Yahoo! Mail Plus account?

Not currently, but this is an excellent feature that is high on the development priority list.