Public | Automated Build

Last pushed: 2 months ago
Short Description
Linshare's backend component
Full Description

Dockerfile link

What is Linshare?

Open Source secure files sharing application, LinShare is an easy solution to make dematerialized exchanges. For businesses which want confidentiality, and traceability for their file exchanges. LinShare is a libre and free, ergonomic and intuitive software, for transferring large files.



  • File upload into its own personal space,
  • File sharing to internal, external, or guest persons,
  • Shares management and collaborative exchange space,
  • Security : authentication, time-stamping, signature, confidentiality, and anti-virus filter,

How to use this image

To be fully operational, Linshare requires several components :

  • SMTP server
  • Database server (Postgres drivers included)
  • ClamAV service (optional)


You can configure the above related settings through the following environment variables :

Environment variable Description
CLAMAV_HOST clamav host
CLAMAV_PORT clamav port
JAVA_OPTS java env variables
SMTP_HOST smtp host
SMTP_PORT smtp port
SMTP_USER smtp user
SMTP_PASS smtp password
POSTGRES_HOST postgres host
POSTGRES_PORT postgres port
POSTGRES_USER postgres user
POSTGRES_PASS postgres password
POSTGRES_DATABASE postgres database with default value "linshare"
MONGODB_HOST mongodb host
MONGODB_PORT mongodb port
MONGODB_USER mongodb user
MONGODB_PASS mongodb password
REPLICA_SET (optional) replica-set for "linshare" database (if not set MONGODB_HOST and MONGODB_PORT will be used)
REPLICA_SET_BIGFILES (optional) replica-set for "linshare-files" database (if not set MONGODB_HOST and MONGODB_PORT will be used)
REPLICA_SET_SMALLFILES (optional) replica-set for "linshare-bigfiles" database (if not set MONGODB_HOST and MONGODB_PORT will be used)
SPRING_PROFILES_ACTIVE (optional) default value is 'default,jcloud,mongo'. To enable sso, use 'sso,jcloud,mongo'
SSO_IP_LIST_ENABLE enable trusted list of sso server ip. (default=false)
SSO_IP_LIST (optional) Trusted list of sso server ip. (default="")
STORAGE_MODE Available storage mode: <ul><li>filesystem : storing documents on file system<br/>dependent variable:<ul><li>STORAGE_BUCKET</li><li>STORAGE_FILESYSTEM_DIR</li></ul><li>swift-keystone or openstack-swift : storing documents into swift<br/>dependent variable:<ul><li>STORAGE_BUCKET</li><li>STORAGE_SWIFT_IDENTITY</li><li>STORAGE_SWIFT_CREDENTIAL</li><li>STORAGE_SWIFT_ENDPOINT</li></ul></li></ul>
STORAGE_BUCKET storage bucket id; default: e0531829-8a75-49f8-bb30-4539574d66c7
STORAGE_FILESYSTEM_DIR storage filesystem directory; default: /var/lib/linshare/filesystemstorage
STORAGE_SWIFT_ENDPOINT storage swift endpoint e.g.:
STORAGE_SWIFT_IDENTITY storage swift identity e.g.: tenant_name:user_name
STORAGE_SWIFT_CREDENTIAL storage swift credential e.g.: password
STORAGE_SWIFT_REGION_ID Region ID is required with openstack-swift.
THUMBNAIL_ENABLE (optional) By default it is disabled : false true
THUMBNAIL_HOST (optional) Thumbnail host : thumbnail-server
THUMBNAIL_PORT (optional) Thumbnail port : 8080


We add three mongodb environment variables in orther to specify the mongodb replica-set for each database.

Each environment variable must be set like this: "ip-adress-of-first-mongodb:mongodb-port,ip-adress-of-second-mongodb:mongodb-port,...".

For exemple if we had a replica-set of three mongodb replication for the "linshare-bigfiles" database we can add:



To start using this image with the defaults settings, you can run the following commands :

$ docker run -d -p 8080:8080 linagora/linshare-backend

And if any changes are necessary you can set the new values by passing them as follow :

$ docker run -it --rm -p 8080:8080 \
-e \
-e SMTP_PORT=25 \
-e SMTP_USER=linshare \
-e SMTP_PASS=linshare \
-e \
-e POSTGRES_USER=linshare \
-e POSTGRES_PASS=linshare \
-e \
-e CLAMAV_PORT=4410 \
-e JAVA_OPTS="-Xms1024m" \

Data persistency

Data persistency on Docker host is provided by the Docker volume runtime flag (-v).

To enable it, at any time, run this image like as in the following example :

$ docker run -d -p 8080:8080 -v /var/lib/linshare:/var/lib/linshare linagora/linshare-backend:1.11.4


This repository is capable of building stable or snapshot release of Linshare.
You can set a custom version number on the command-line by using the --build-args switch.

CHANNEL argument can be set to releases or snapshots.
Stable releases channel is selected by default.

Version is for Linshare-core version. It's set to latest version by default.

$ docker build --build-arg VERSION=1.11.5 CHANNEL=snapshots -t linshare-backend .


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


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


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

Docker Pull Command