Skip to content
Go to file

Latest commit


Git stats


Failed to load latest commit information.
Latest commit message
Commit time

Conforguration README


Use the power of Org to configure accounts and servers.

How does it work?

Run M-x org-babel-tangle (C-c C-v t) on to generate installation scripts in the conforguration_scripts/ and dotfiles/ directories.


Raw dotfiles are in dotfiles/. Because they start with a dot (e.g. .bashrc) they are not visible to ls normally, so use ls -a to see them.

Dotfiles are copied to $HOME/dotfiles/ and symlinks are made from your home directory to there.

Installing applications and packages

Sync the scripts to remote servers, then run the scripts on those remote servers. Or run them locally!

The nice things about this is that either locally or remotely, you can use C-c C-c on the shell blocks to execute them, or you can run the scripts at the command line.

How to install Emacs from scratch the Conforguration way

Warning: this will overwrite all sorts of VERY IMPORTANT files, so you don’t do this unless you’re me, or you’re on a new bare system and want to try it out.

sudo apt-get install git
git clone
mkdir -p src
cd src
git clone
cd conforguration/dotfiles
source ~/.bashrc
cd ../scripts

Then run emacs. A few dozen packages will be downloaded and installed and when that’s done your Emacs will look exactly like mine! If you don’t want to go that far, skip the .emacs.d repository download, but make sure your PATH is set up to point to Emacs in the right place under /usr/local/src/.


Because Ansible and similar configuration management tools aren’t done in Org.

What next?

I don’t know, but if you’re interested, have at it.

There is a lot of duplication. Perhaps there is a nice way to tidy that up.


GPL v3. See COPYING for details.


Configure things with Org.




No releases published


No packages published
You can’t perform that action at this time.