ibcndevs/limeds repository overview

⁠LimeDS Standalone Docker Container

This is a dockerized version of the standalone builds of the LimeDS Platform. More information about LimeDS can be found at http://limeds.intec.ugent.be⁠

⁠Getting started

⁠Create and start a LimeDS container

docker run -d -p 8080:8080 --name limeds ibcndevs/limeds

This creates and runs a container in detached mode. It is called limeds. Now browse to http://localhost:8080/editor⁠ in (a chrome) browser to get started immediatly.

⁠Stop the container

docker stop limeds

Stops the container and LimeDS with it.

⁠Start the existing container

docker start limeds

Starts the limeds container with its data volumes attached again

⁠Update the existing container

Updating the image, won't automatically update your container, which will still be based on the older image. With the following script sequence below, you can update the container by making a new one, base on the newest image. It should keep your data intact. These are the steps explained:

• pull the newest image
• stop the current container
• rename the current container
• start a new container from the new images attached to the same volumes of the old container
• start the new container
• remove the old container

docker pull ibcndevs/limeds:latest
docker stop limeds
docker rename limeds limeds_old
docker run -d -p 8080:8080 --name limeds --volumes-from limeds_old ibcndevs/limeds
docker rm limeds_old

Updates the container by spinning up a new one with the same volumes. The last line deletes your old container!

⁠Advanced topics

⁠About ports

The standard port for LimeDS is 8080, normally this can be changes through configuration of LimeDS. However Docker allows for an easyier port redirection mechanism: the -p trigger.

You may have noticed the -p 8080:8080 in the run command. This maps your host's 8080 port to the container's 8080 port. To map to your host's port 80 for instance, change this to -p 80:8080 when running/creating the container for the first time.

⁠About volumes

There are 3 mount points, for which anyonymous volumes are created automatically if you don't mount them manually (through the -v trigger):

• /limeds/slices
• /limeds/config
• /limeds/felix-cfg

These anonymous volumes allow persistent storage for everything you create through LimeDS while the instance is running