Richard Bucker

Quick-Start Fossil SCM

Posted at — Apr 10, 2015

There is something to be said about Git and Mercurial. They are clearly the leaders of the pack and there are many good reasons to like them. However there may be as many to hate them too and here’s a short list.

And there is a lot to like about fossil
  • single file repo making it easy to backup and restore
  • single executable
  • based on SQLite; from the SQLite author
  • embedded wiki and issue tracker
While there is feature parity fossil features are not embedded in Go and that’s as good a reason to be upset as any. All that said I still want to deploy my latest fossil repo. As such this is the quick-start.

My environment is (a) my MacBook (b) a google compute engine instance running CoreOS. Right now I’m planning to run the remote fossil instance directly on my CoreOS instance, however, it should be moved to a docker container as soon as possible. (should be easy enough).

Quick Start
  1. install fossil on the target machines. (not going to describe that)
  2. Let’s start on the mac
    1. mkdir $HOME/fossil.repo
    2. cd $HOME/fossil.repo
    3. fossil init example.fossil
    4. cd $HOME
    5. mkdir -p $HOME/src/fossil-scm/example
    6. cd $HOME/src/fossil-scm/example
    7. fossil open $HOME/fossil.repo/example.fossil
    8. echo “richard bucker” >> contributors.txt
    9. fossil add .
    10. fossil commit -m “initial import of contributors”
  3. now let’s register the remote repo
    1. scp example.fossil <username>@<hostname>:./fossil.repo/.
    2. fossil remote-url  ‘ssh://<username>:<pwd>@<IPADDR>//path_to_repo/fossil.repo/example.fossil?fossil=/path_to_fossil_bin/fossil’
    3. fossil sync
I was not crazy about the scp in 3.1 but I guess that’s the only way it works. I suppose the intent is to create the repo on the remote system and then clone it locally. These steps and specifying where the fossil executable is located, when using ssh, are just a few more steps. There are clearly a few more steps required in order to get a server running. Maybe another day because it requires setting up a webserver as a reverse proxy.