Running with Docker Desktop
Running on Windows with Docker Desktop
When running with Docker, Medley runs in a Docker container using the Interlisp/medley image found on Docker Hub. A VNC Viewer window is used to display the Medley desktop. All of this is started up using the single
These instructions are for Windows 10 or 11 (x86_64) only.
To install and run Medley with Docker Desktop:
Install Docker Desktop: Install Docker Desktop for Windows as described here.
Install Medley: To install Medley, download and run the the
medley-install_<version>.exethat can be found here under the Windows 10/11 heading.
This will install Medley on your system, by default in the
%USERPROFILE%/AppData/Local/Medley/Scriptsfolder. This folder will be added to your %PATH%. An uninstall will also be added so that you can remove Medley via the standard Add/Remove Programs control panel.
Note that to download
medley-install_<version>.exe, you may have to bypass any security concerns your browser has about downloading an .exe file. In addition, you will have to bypass the Windows Defender protection against executing an unsigned .exe. To do so, click
More infofollowed by
Run Anywaywhen the Windows Defender window pops up.
Run Medley: Once it is installed, you can run Medley by typing
medley <flags and options>into either a Command or a Powershell window.
Documentation for the
<flags and options>to the
medleycommand can be found here
For first-time users:
medley --apps --interlisp --noscrollor, equivalently,
medley -a -e -nis a good starting point. This will give you a fully populated Medley system, including some applications built on Medley such as Notecards and Rooms.
Docker needs to be installed and running in order to run Medley. However, the Docker Dashboard window does not be open. You can check the state and start/stop Docker by right clicking on the Docker icon in the System Tray.
The first time it runs,
medleywill automatically pull the latest Interlisp/medley docker image from Docker Hub. It will use this docker image for all subsequent runs unless the ‘–update’ flag is raised. When –update is raised,
medleywill once again pull the latest Interlisp/medley docker image.
When running with Docker, the Medley file system is for the most part “within” the Docker container. This means that it is deleted whenever Medley stops and is recreated whenever Medley restarts. The exception is the directory
/home/medley/il(in the Medley file system) which is automatically mapped by
medleyto a directory in the host Windows file system, by default to
%USERPROFILE%/AppData/Local/Medley/ilfolder. You can change this mapping to a different windows folder using the