mirror of
https://github.com/sismics/docs.git
synced 2024-11-22 14:07:55 +01:00
139 lines
5.0 KiB
Markdown
139 lines
5.0 KiB
Markdown
<h3 align="center">
|
|
<img src="https://www.sismicsdocs.com/img/github-title.png" alt="Sismics Docs" width=500 />
|
|
</h3>
|
|
|
|
[](https://twitter.com/sismicsdocs)
|
|
[](https://www.gnu.org/licenses/old-licenses/gpl-2.0.en.html)
|
|
[](http://travis-ci.org/sismics/docs)
|
|
|
|
Docs is an open source, lightweight document management system for individuals and businesses.
|
|
|
|
**Discuss it on [Product Hunt](https://www.producthunt.com/posts/sismics-docs) 🦄**
|
|
|
|
<hr />
|
|
<h2 align="center">
|
|
✨ We just launched a Cloud version of Sismics Docs! Head to <a href="https://www.sismicsdocs.com/">sismicsdocs.com</a> for more informations ✨
|
|
</h2>
|
|
<hr />
|
|
|
|
|
|
|
|
Demo
|
|
----
|
|
|
|
A demo is available at [demo.sismicsdocs.com](https://demo.sismicsdocs.com)
|
|
- Guest login is enabled with read access on all documents
|
|
- "admin" login with "admin" password
|
|
- "demo" login with "password" password
|
|
|
|
Features
|
|
--------
|
|
|
|
- Responsive user interface
|
|
- Optical character recognition
|
|
- Support image, PDF, ODT, DOCX, PPTX files
|
|
- Video file support 
|
|
- Flexible search engine
|
|
- Full text search in all supported files
|
|
- All [Dublin Core](http://dublincore.org/) metadata
|
|
- Workflow system 
|
|
- 256-bit AES encryption of stored files
|
|
- Tag system with nesting
|
|
- Import document from email (EML format) 
|
|
- Automatic inbox scanning and importing 
|
|
- User/group permission system
|
|
- 2-factor authentication
|
|
- Hierarchical groups
|
|
- Audit log
|
|
- Comments
|
|
- Storage quota per user
|
|
- Document sharing by URL
|
|
- RESTful Web API
|
|
- Fully featured Android client
|
|
- [Bulk files importer](https://github.com/sismics/docs/tree/master/docs-importer) (single or scan mode) 
|
|
- Tested to one million documents
|
|
|
|
Install with Docker
|
|
-------------------
|
|
|
|
From a Docker host, run this command to download and install Sismics Docs. The server will run on <http://[your-docker-host-ip]:8100>.
|
|
**The default admin password is "admin". Don't forget to change it before going to production.**
|
|
|
|
docker run --rm --name sismics_docs_latest -d -e DOCS_BASE_URL='http://[your-docker-host-ip]:8100' -p 8100:8080 -v sismics_docs_latest:/data sismics/docs:latest
|
|
<img src="http://www.newdesignfile.com/postpic/2011/01/green-info-icon_206509.png" width="16px" height="16px"> **Note:** You will need to change [your-docker-host-ip] with the IP address or FQDN of your docker host e.g.
|
|
|
|
FQDN: http://docs.sismics.com
|
|
IP: http://192.168.100.10
|
|
|
|
Manual installation
|
|
-------------------
|
|
|
|
#### Requirements
|
|
- Java 8 with the [Java Cryptography Extension](http://www.oracle.com/technetwork/java/javase/downloads/jce-7-download-432124.html)
|
|
- Tesseract 3 or 4 for OCR
|
|
- ffmpeg for video thumbnails
|
|
- mediainfo for video metadata extraction
|
|
- A webapp server like [Jetty](http://eclipse.org/jetty/) or [Tomcat](http://tomcat.apache.org/)
|
|
|
|
#### Download
|
|
The latest release is downloadable here: <https://github.com/sismics/docs/releases> in WAR format.
|
|
**The default admin password is "admin". Don't forget to change it before going to production.**
|
|
|
|
How to build Docs from the sources
|
|
----------------------------------
|
|
|
|
Prerequisites: JDK 8 with JCE, Maven 3, Tesseract 3 or 4
|
|
|
|
Docs is organized in several Maven modules:
|
|
|
|
- docs-core
|
|
- docs-web
|
|
- docs-web-common
|
|
|
|
First off, clone the repository: `git clone git://github.com/sismics/docs.git`
|
|
or download the sources from GitHub.
|
|
|
|
#### Launch the build
|
|
|
|
From the root directory:
|
|
|
|
mvn clean -DskipTests install
|
|
|
|
#### Run a stand-alone version
|
|
|
|
From the `docs-web` directory:
|
|
|
|
mvn jetty:run
|
|
|
|
#### Build a .war to deploy to your servlet container
|
|
|
|
From the `docs-web` directory:
|
|
|
|
mvn -Pprod -DskipTests clean install
|
|
|
|
You will get your deployable WAR in the `docs-web/target` directory.
|
|
|
|
Contributing
|
|
------------
|
|
|
|
All contributions are more than welcomed. Contributions may close an issue, fix a bug (reported or not reported), improve the existing code, add new feature, and so on.
|
|
|
|
The `master` branch is the default and base branch for the project. It is used for development and all Pull Requests should go there.
|
|
|
|
|
|
Community
|
|
---------
|
|
|
|
Get updates on Sismics Docs' development and chat with the project maintainers:
|
|
|
|
- Follow [@sismicsdocs on Twitter](https://twitter.com/sismicsdocs)
|
|
- Read and subscribe to [The Official Sismics Docs Blog](https://blog.sismicsdocs.com/)
|
|
- Check the [Official Website](https://www.sismicsdocs.com)
|
|
- Join us [on Facebook](https://www.facebook.com/sismicsdocs)
|
|
|
|
License
|
|
-------
|
|
|
|
Docs is released under the terms of the GPL license. See `COPYING` for more
|
|
information or see <http://opensource.org/licenses/GPL-2.0>.
|