rasata / linshare-docker

Linshare-Docker

Docker is available here and docker-compose here. Make sure that these are installed on your system before starting.

• Docker can be installed with the following lines on most distros :

$ curl -sSL https://get.docker.com | sudo curl

• docker-compose can be installed as :

# As a python package
$ pip install docker-compose

Presentation

Deploy a Linshare instance with ease using Docker and docker-compose

This docker-compose aims to make possible to quickly run a Linshare appliance. It consists of several containers :

• Tomcat with Linshare server
• Postgresql for the server
• Apache2 with Linshare Admin's interface
• Apache2 with Linshare UploadRequest's interface
• Apache2 with Linshare User's interface
• Apache2 acting as a reverse-proxy for the above (except Postgresql)
• Opensmtp server configured in relay mode
• ClamAV server to be used by Tomcat
• LDAP directory containing some sample users. see
• An init container: it will create a domain with a connexion to the embedded LDAP.

Most of the containers can be configured to suits your needs, the available settings are either already used (and you have just to replace them) or commented out. Automatic upgrades for data used by containers is not available.

How to use it

# use this line to launch it
$ docker-compose up -d

# use this line to see logs for all containers
$ docker-compose logs

# use this line to stop
$ docker-compose stop

# use this line to delete previously created containers
$ docker-compose down

# use this line to delete all data created by containers (reset all modifications)
$ sudo rm -fr data

By default the containers are listenning to linshare.local so you may have to add the following lines in your hosts file :

127.0.0.1   admin.linshare.local user.linshare.local linshare.local traefik.linshare.local

And all uses the https protocol via the port 443.

Quick start

Once everything is running, you can start using LinShare home page.

If you do not want to use the init container, you can setup the link with the LDAP manually with the following guide:

1. Browse to admin.linshare.local and log in using
   • mail : [email protected]
   • password : adminlinshare
2. Select Domain → LDAP connections
   • Click on the '+' icon
   • Fill the fields with your LDAP credentials
   • Hit Save
3. Select Domain → Domain patterns
   • In Model selector chose default-pattern-demo
   • Fill the field Name
   • Hit Save
4. Select Domain → Manage domains
   • Click on the '+' button after LinShareRootDomain
   • Fill the fields Identifier, Name and Description
   • Leave Inter-domains communication rules to DefaultDomainPolicy
   • Select the wanted settings for the remaining fields
   • Click on Add provider
   • Select the previous created elements in step 2 and step 3 for each fields and provide your Base dn in the last one
   • Hit Save
5. You can now go user.linshare.local and start using your LDAP users.
   • [email protected] : password1
   • [email protected] : password2
   • ... to user7

License

View license information for the software contained in this image.

Supported Docker versions

This image is officially supported on Docker version 1.9.0.

Support for older versions (down to 1.6) is provided on a best-effort basis.

Please see the Docker installation documentation for details on how to upgrade your Docker daemon.

User Feedback

Documentation

Official Linshare documentation is available here : Linshare Configuration Guide (pdf format).

Issues

If you have any problems with or questions about this image, please contact us through a GitHub issue.