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 medley
command.
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>.exe
that 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/Scripts
folder. 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, clickMore info
followed byRun Anyway
when 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 themedley
command can be found hereFor first-time users:
medley --apps --interlisp --noscroll
or, equivalently,medley -a -e -n
is a good starting point. This will give you a fully populated Medley system, including some applications built on Medley such as Notecards and Rooms.
Notes:
-
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,
medley
will 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,medley
will 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 bymedley
to a directory in the host Windows file system, by default to%USERPROFILE%/AppData/Local/Medley/il
folder. You can change this mapping to a different windows folder using the--logindir
option tomedley
.