Mounting Google Documents in GNU/Linux is just not a (real) option

Short URL:


If you use Google Documents, you might want to be able to access your files without using a browser. So, I was all set, happy to write a good blog entry about how to mount your Google Documents folder on your Ubuntu. (This is not a very free-software thing to do, granted. But then again, if you are an Ubuntu One user, well, Ubuntu One server isn't free software either. But, it's a service, and interfacing to things is crucial.)

So, is it actually possible?

Well, the short answer, if you want to use Google Documents as a file system, is simple: "forget it". The reality is that Google Document is just not meant to be used in any way other than within your browser; it's not an online storage service: it's a fully lock-in proprietary document management service.

Let's see why.

Installing google-docs-fs

Google-Docs-Fs is written in Python. This seems to be a good start, since Google users Python a lot internally @ Google. It's the best option if you want to access Google Documents straight as a file system.

First of all, in the project's home page you are presented with two files:

  • google-docs-fs-1.0rc1.tar.gz
  • google-docs-fs-1.0rc1_all.deb

Before you jump ahead and install things, you will need to install the underlying needed library: python-gdata. If you click on "All downloads", you will also see a handy link to the libraries needed by this package:

  • python-gdata_2.0.14-1_all.deb

HINT: Install the package "python-gdata" from your own distribution, and not the one provided by the maintainer. There are different versions of Python, and if you are using the latest Ubuntu, for example, the provided package will install for the wrong version of Python, and nothing will work.

At this point, you will need to install google-docs-fs itself. Again, I tried the .deb provided by the author, but in my latest Ubuntu the installation was for Pythin 2.6. So, I had to go the manual way: I downloaded google-docs-fs-1.0rc1.tar.gz, unzipped it, and installed it:

[email protected]:~$ wget


2012-01-02 11:48:32 (36.5 KB/s) - `google-docs-fs-1.0rc1.tar.gz' saved [13880/13880]

[email protected]:~$ tar xvzf google-docs-fs-1.0rc1.tar.gz 

[email protected]:~$ cd google-docs-fs/
[email protected]:~/google-docs-fs$ sudo ./ install[sudo] password for merc: 
running install
running build
running build_py
running build_scripts
running install_lib
running install_scripts
changing mode of /usr/local/bin/gumount to 775
changing mode of /usr/local/bin/ to 755
changing mode of /usr/local/bin/gmount to 775
running install_egg_info
Writing /usr/local/lib/python2.7/dist-packages/google_docs_fs-1.0rc1.egg-info
[email protected]:~/google-docs-fs$ 

At this point, you are ready to use it.

Using google-docs-fs

First of all, create a directory called "google" in your home directory running the command mkdir ~/google. At this point, run the command gmount google [email protected] (obviously, YOUREMAIL is your email address). You should be prompted with a password request: type it in, and you should be good to go.

Notice the "should".

The response time is quite slow: browsing between directory can be really quite painful even with a pretty fast connection. If you used Google Docs, you know that it has different types of files: "uploaded" ones (which are not changed), and the "managed" ones (which can be edited by multiple people at the same time: for example Documents, Spreadsheets, Presentations, etc.). This is all great while using the web interface, but definitely gets in the way when you are trying to use it as a file system.

For example, create a file called "file.txt". Write something on it. Then save it, and quit. Relax: It will take you a little while to make this happen. The result of this operation is not what you would expect: when you see the directory listing again, you will see "file.txt.doc" in the folder. Google Documents actually converted the file into a DOC file! (Why the silent conversion? And why not ODF?)

Browsing the file system, I also noticed that files that I had created as .txt are actually .txt.doc (although Google's interface hides this from me when I am browsing the files using its browser).

Final thoughts

Only one thought: don't. I am writing these finishing lines as the module hanged on me and I had to reboot my computer to get rid of the share. It's very slow to use, and the "background work" done by Google just gets in the way too much.

Google Documents is a proprietary service for advanced document management. Using it as storage is like trying to fit a circle into a box. It might fit eventually, bit it just won't work right.

The failed paths

While writing this article, I stumbled upon a few dead ends. Here they are.

(No) Way #1: gdocsfs

GDocsFS is written in Java. Before you get too excited about it, have a look at this post -- in the 1st of December 2011, the author writes:

Comment 9 by project member, Dec 1, 2011 Hi guys,

Excuse me for not responding this issues, now I'm using github for a while and forgetting to take a look here. Since this project is being used I will reactive it, maybe I will rewrite it from the scratch and implement some requested features like write support. but the source code will be hosted on github. Besides write support what other features could be added? I have created an issue to collect suggestions here . possibly we have a beta version still in this year.

It's read-only, and the developer "might" rewrite it in the future.

(No) Way #2: Google Doc Mount (GTK)

Google Doc Mount is meant to be a GTK application that allows you to easily mount your Google Docs file system, using just the GUI.

Before you get too excited: the package doesn't seem to be available once you have added the PPA using the command line.

Reading the project page, you read:

Now be warned, if you try this, remember that it’s not a supported piece of software, bugs aren’t likely to be fixed (unless you fix them of course) the code is available and it should work on Lucid. It won’t be ported to any other versions (at least by me) but it should be easy to recompile everything for other versions anyway.

The latest comment by the author is even clearer:

doctormo says: 2011-06-11 at 15:55 Aproposnix: It was never maintained to begin with, it was and still is a proof of concept which may or may not still work. Some people have reported success simply installing the deb file for the first release. It was never a project, just an experiment to prove it could be done.



arseshan's picture
Submitted by arseshan on

One can upload and download files from Google Docs by the click of a button. Moreover you can download them files in any format you want. With the way humans are connected these days, I doubt if there is any requirement for such "OFFLINE" use at all. The only kind of people who might require such "OFFLINE" content must be those like budget independent researchers who work in remote areas!!! They can use software like Libre office and upload them later when they reach places with connectivity. SO WHAT'S THE BIG FUSS ABOUT???? GOOGLE DOCS IS GREAT.

Tony Mobily's picture


This article was about "mounting" a Google Docs account so that it looked like it was part of your computer's file system.
I never spoke of "offline" mode...

So I am not sure I am following you!


jrr's picture
Submitted by jrr on

This article is about mounting a remote file system (Google Doc's file system). If you go offline, any remote file systems you have mounted become unavailable. Google Docs has had an offline feature for a long time, but that is separate from this.

Author information

Tony Mobily's picture


Tony is the founder and the Editor In Chief of Free Software Magazine