How to deploy LMDS?

Before you start using LMDS, set your Server IP address to be static, it will make some things easier later on. Static IP address is not absolutely necessary just to try the project and to find out if you like it or not, but in production would be better to have a static IP on the server.

install Git:

sudo apt-get install git

Clone LMDS repository:

git clone https://github.com/GreenFrogSB/LMDS.git ~/LMDS

Do not change name of the folder on your local system, it should stay as is for the script to work properly

Enter the directory and run:

cd ~/LMDS
./deploy.sh
  • First Install Docker & Docker-compose
  • Second Build LMDS Stack by selecting containers to deploy.
  • Configure containers you deploy by pointing your browser at the LMDS IP address, followed by the port number of the container.
  • Explore other options in the menu and visit FAQ for more advanced instructions.

LMDS main menu

LMDS containers and their ports:

Numbers after ":" identify a port that particular container will respond on, i.e. Portainer default port is :9000, point your browser at LMDS server IP:PORT in order to see Portainer login page.

https://SERVER-IP:9000

Portainer

All the Docker containers are being created by docker-compose.yml file – this file is updated each time you lunch deploy.sh script where all depend from selection you make in the menu. This docker-compose file can be found inside LMDS folder after first successful deployment. You can edit it manually if you know what you are doing or keep lunching deploy.sh script and selecting/deselecting containers there.

After deployment is completed all the containers settings are stored in persistent volumes inside ~/LMDS/volumes/ folder, keep this folder safe - all configuration you make for the containers using Web GUI are stored there. If you want to factory reset a container, stop it, delete container instance and then delete relevant folder from within ~/LMDS/volumes/, then deploy container again. This will recreate folder you just deleted but with default container settings as if that container never existed before.

Containers can be deleted and recreated or modified; you can do this by editing docker-compose file and running docker-compose up -d. You can also do some changes to the containers using Portainer GUI if this is more convenient.

Get yourself familiar with docker-compose.yml file. This file will tell you which folders/volumes are mapped to which container, this knowledge will allow you to better understand where data should be kept and from where containers can read them. Knowing above you could map your remote storage to particular folder and then present it to the container rather than storing all media files on RPi SD card.

For more details, please check FAQ section on this site.

Help me make LMDS better

With your support anything is possible