EveryDocs Core is the server-side part of EveryDocs. This project contains a web interface. All in all, EveryDocs is a simple Document Management System (DMS) for private use. It contains basic functionality to organize your documents digitally.
- Uploading PDF documents with a title, description and the date the document was created
- Organizing documents in folders and subfolders
- Adding people and processing states to documents
- Extracting the content from the PDF file for full-text search
- Searching all documents by title, description or content of the document
- Creating new accounts (be aware that at the current moment everybody who knows the URL can create new accounts)
- Authentication via JsonWebToken
- REST-API for all CRUD operation for documents, folders, persons and processing states
- Mobile-friendly web UI
Screenshots of the web interface
Start the container and make the API accessible on port
8080 by running the following commands. Of course, you can change the port in the last command.
Also make sure to check the folder that is mounted into the container. In this case, the uploaded files are stored in
/data/everydocs on the host.
docker run -p 127.0.0.1:8080:5678/tcp -e SECRET_KEY_BASE="$(openssl rand -hex 64)" -v /data/everydocs:/var/everydocs-files jonashellmann/everydocs
You can configure the application by using the following environment variables:
EVERYDOCS_DB_ADAPTER: The database adapter (default:
EVERYDOCS_DB_NAME: The name of the database (default:
EVERYDOCS_DB_USER: The user for the database connection (default:
EVERYDOCS_DB_PASSWORD: The password for the database connection (no default)
EVERYDOCS_DB_HOST: The host of the database (default:
EVERYDOCS_DB_PORT: The port of the database (default:
You might want to include this container in a network so it has access to a database container. Also there are ways to connect to a database that runs on the host (e.g. see Stackoverflow).
Manual Installation (not recommended)
- Make sure you have Ruby installed. For an installation guide, check here: Ruby installation guide
- If you haven't installed the Rails Gem, you can run the following command:
gem install rails
- Download the newest release and unzip it in a location of your own choice.
- Configure your database connection by setting the following environment variables:
EVERYDOCS_DB_PORT. You can do so by editing the
- Configure the folder where documents are stored in config/settings.yml.
The default location is
- Install required dependencies by running:
- You might want to change the port of the application in
- Setup your database by running:
rake db:migrate RAILS_ENV=production. If there is an error, you might need to execute the following command, to set an encryption key:
EDITOR="mate --wait" bin/rails credentials:edit
- Make sure that the environment variable
SECRET_KEY_BASEhas a value. If not, you can generate a key by running
rake secretand set it by editing the
start-app.shscript. In case your not using production as your environment, the environment variable
SECRET_KEY_BASE_TESTneeds to be set.
- Start your Rails server:
- Access the application on http://localhost:5678 or configure any kind of proxy forwarding in your webserver.
- If you wish to use this application in your web browser, consider to install EveryDocs Web!
- Stop the application:
To backup your application, you can simply use the backup functionality of your database. For example, a MySQL/MariaDB DBMS may use mysqldump.
Additionally you have to backup the place where the documents are stored. You can configure this in config/settings.yml. To restore, just put the documents back in that location.
To learn about the routes the API offers, run the following command: