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,
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 (optional) | smtp user |
| SMTP_PASSWORD (optional) | smtp password |
| SMTP_START_TLS_ENABLE | enable start tls |
| SMTP_SSL_ENABLE | enable ssl (force ssl only) |
| POSTGRES_HOST | postgres host |
| POSTGRES_PORT | postgres port |
| POSTGRES_USER | postgres user |
| POSTGRES_PASSWORD | postgres password |
| POSTGRES_DATABASE | postgres database with default value "linshare" |
| MONGODB_DATA_DATABASE | LinShare database name, default: linshare |
| MONGODB_DATA_REPLICA_SET | mongodb replica set value, format: host1[:port1][,host2[:port2],...[,hostN[:portN]]][?options]] ex: mongo-host-1:27017,mongo-host-2:27017,mongo-host-3:27017?replicaSet=rs0 |
| MONGODB_SMALLFILES_DATABASE | LinShare database name for thumbnail storage, default: linshare-files |
| MONGODB_SMALLFILES_REPLICA_SET | mongodb replica set value for smallfiles, format: host1[:port1][,host2[:port2],...[,hostN[:portN]]][?options]] |
| MONGODB_USER | user, default: linshare |
| MONGODB_PASSWORD | enable authentication if defined. |
| MONGODB_AUTH_DATABASE | Authentication database, default: admin |
| MONGODB_WRITE_CONCERN | Available Write concern value:
|
| SPRING_PROFILES_ACTIVE (optional) | default value is 'default,jcloud,batches'. To enable sso, use 'sso,jcloud,batches' |
| 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 |
| THUMBNAIL_ENABLE (optional) | By default it is disabled : false |
| THUMBNAIL_HOST (optional) | Thumbnail host : thumbnail-server |
| THUMBNAIL_PORT (optional) | Thumbnail port : 8080 |
| JWT_EXPIRATION (optional) | Jwt expiration : 300 |
| JWT_TOKEN_MAX_LIFETIME (optional) | Jwt token max lifetime : 300 |
| START_DEBUG | if equal to 1, additionnal debug traces will be displayed. |
| LS_DEBUG | if equal to 1, it enables debug traces for LinShare (log4j configuration) |
| LOG4J2_APPENDER | defines the Log4J appender used for logging (default=CONSOLE, available values: CONSOLE, CONSOLE_JSON & LINSHARE) |
| Deprecated Environment variable | Description |
|---|---|
| MONGODB_URI | mongodb uri (Deprecated, LinShare 2.3 and below) |
| MONGODB_URI_SMALLFILES | mongodb uri for smallfiles (Deprecated, LinShare 2.3 and below) |
| STORAGE_MODE=filesystem | storing documents on file system |
|---|---|
| STORAGE_BUCKET | storage bucket id; default: linshare-data (old value was e0531829-8a75-49f8-bb30-4539574d66c7) |
| STORAGE_FILESYSTEM_DIR | storage filesystem directory; default: /var/lib/linshare/filesystemstorage |
| STORAGE_MODE=swift-keystone | storing documents into swift |
|---|---|
| STORAGE_BUCKET | storage bucket id; default: linshare-data (old value was e0531829-8a75-49f8-bb30-4539574d66c7) |
| STORAGE_MULTIPART_UPLOAD | uploading file to ObjectStorage using multipart chunking. Default: true |
| OS_AUTH_URL | |
| OS_TENANT_NAME | |
| OS_USERNAME | |
| OS_PASSWORD |
| STORAGE_MODE=openstack-swift | storing documents into swift with region support |
|---|---|
| STORAGE_BUCKET | storage bucket id; default: linshare-data (old value was e0531829-8a75-49f8-bb30-4539574d66c7) |
| STORAGE_MULTIPART_UPLOAD | uploading file to ObjectStorage using multipart chunking. Default: true |
| OS_IDENTITY_API_VERSION | Default: 2. Values: 2 or 3 |
| OS_AUTH_URL | ex: https://auth.cloud.ovh.net/v2.0/ or https://auth.cloud.ovh.net/v3 |
| OS_TENANT_ID | required if api version v2 |
| OS_TENANT_NAME | required if api version v2 |
| OS_USERNAME | |
| OS_PASSWORD | |
| OS_REGION_NAME | |
| OS_PROJECT_NAME | required if api version v3 |
| OS_USER_DOMAIN_NAME | required if api version v3 |
| STORAGE_MODE=s3 | storing documents into Amazon s3 (tested with minio) |
|---|---|
| STORAGE_BUCKET | storage bucket id; default: linshare-data (old value was e0531829-8a75-49f8-bb30-4539574d66c7) |
| STORAGE_MULTIPART_UPLOAD | uploading file to ObjectStorage using multipart chunking. Default: true |
| AWS_AUTH_URL | Endpoint of S3 server : ex: https://s3.amazonaws.com |
| AWS_ACCESS_KEY_ID | S3 access key |
| AWS_SECRET_ACCESS_KEY | S3 secret access key |
If you want to add a new CA to this image at runtime, please add your file using a volume in /new-ca folder. All file in this folder will be added to Tomcat keystore.
To start using this image with the defaults settings, you can run the following commands :
$ docker run -d -p 8080:8080 linagora/linshare-backendAnd if any changes are necessary you can set the new values by passing them as follow :
$ docker run -it --rm -p 8080:8080 \
-e SMTP_HOST=smtp.linshare.com \
-e SMTP_PORT=25 \
-e MONGODB_DATA_REPLICA_SET=mongodb.linshare.com:27017 \
-e MONGODB_SMALLFILES_REPLICA_SET=mongodb.linshare.com:27017 \
-e MONGODB_USER=linshare \
-e MONGODB_PASSWORD=linshare \
-e POSTGRES_HOST=postgres.linshare.com \
-e POSTGRES_USER=linshare \
-e POSTGRES_PASSWORD=linshare \
-e CLAMAV_HOST=clamav.linshare.com \
-e CLAMAV_PORT=4410 \
-e JAVA_OPTS="-Xms1024m" \
linagora/linshare-backendData 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:4.0.0This 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 CHANNEL=snapshots -t linshare-backend --build-arg VERSION=2.2.0-SNAPSHOT .View license information for the software contained in this image.
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.
Official Linshare documentation is available here : Linshare Documentation Guide.
If you have any problems with or questions about this image, please contact us through a GitHub issue.