Skip to content

Instantly share code, notes, and snippets.

What would you like to do?
Setup instructions for the Emacs Workshop

Hello everyone,

to get your system ready there are two ways to proceed. One using a Virtualbox setup, the other installing all needed on your personal machines.

VirtualBox version

You need to install VirtualBox. Go to and Download and install the application (for linux users, you can check if your distro has official packages). After you have done that you will want to download and unzip the file (2.6 Gb compressed, 6.2 expanded) and the virtualbox file (both on the same folder). You can then proceed to add it into Virtualbox (On the Menu Machine->Add).

After that, make sure that you can log into the machine (username and password are emacs). You should see the Emacs icon on the left hand launcher.

Your machine

The following things need to be installed:

Emacs itself. You can find download packages at The init file at Save it as init.el inside a folder called .emacs.d under your home directory (~/.emacs.d/init.el for Linux and MacOs systems, and %userprofile%/.emacs.d/init.el for Windows)

For part of the workshop we are going to use a small bit of Clojure (don't worry, no need to know anything about Clojure, is just a simple example to show what Emacs can do). So you will need to install Java 8 (for linux users, openjdk-8 is fine), which you can find at . You will need to also install leiningen. Instructions for installation are at

Finally, in which ever folder you prefer, run the command lein new testemacs to create a new basic project. If you start Emacs now, it should get all things needed for the workshop.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment