Prerequesites

You need access to the server running ownCloud in order to install the E2EE app.

Download

Download the latest e2eeshare version from https://epikshare.com/downloads/

Manual Installation

  1. Find you apps folder within your ownCloud installation (Linux: /var/www/oc/apps )

  2. Unzip the e2eeShare package into this folder:

    cd /var/www/oc/apps
    tar -xzf ~/Downloads/e2eeshare-1.2.5.tgz
  3. Verify that the zip is successfully extracted:

    owncloud
    ├── apps
    ...
    │   ├── e2eeshare
    |   |   ├── ajax
    │   │   ├── appinfo
    │   │   ├── controller
    │   │   ├── css
    │   │   ├── db
    │   │   ├── img
    │   │   ├── js
    │   │   ├── l10n
    │   │   ├── lib
    │   │   └── templates
    ...
  4. Login to ownCloud as the admin user. You might be asked for an upgrade, if the E2EE app was installed before.

Administration Setup

  1. Open the Admin Settings and visit thesection. Enter your license key in the provided text area:


  2. Select, which key storages will be available for your users. You may provide different settings for ownCloud and guest users.

    If you provide more than one key storage options, users have to set up their key storage in their personal settings prior to being able to read and save encrypted files. This must be communicated in advance to avoid any confusion.

  3. By default all users are enabled to user the E2ee app. If you want to restrict usage to specific groups only, you may set them in the Authorized Groups section. If you provide one or more groups here, only members of those groups may set a folder as E2ee encrypted. Click the apply button, when you are done.


  4. If you have the Guests app installed, make sure e2eeshare is added to the app whitelist. The Guests app is found in thesection.


FAQ

I got a valid license, but when installing it, I still get a message that the system is unlicensed.

This usually happens, when you did not specify correct URL(s) for your license keys. Make sure to send us the exact URL(s) the system will be visible from (i.e. https://example.com/owncloud) -> basically everything before index.php. If you plan to use different URLs for the same installation make sure to send us all of them.

The installation did not create the correct tables.

The E2EE app uses 4 tables. On some system configurations the update seemed to fail. Please notify us of your configuration so we can fix the issue.

If you want to manually add the tables here is the current schema:

CREATE TABLE `oc_e2eeshare_filekeys` (
  `parent_id` bigint(20) unsigned NOT NULL,
  `path` text COLLATE utf8mb4_bin,
  `key_id` varchar(32) COLLATE utf8mb4_bin NOT NULL,
  `filekey` text COLLATE utf8mb4_bin NOT NULL,
  `created` int(10) unsigned NOT NULL,
  KEY `e2ee_parent_id_index` (`parent_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin ROW_FORMAT=COMPRESSED

CREATE TABLE `oc_e2eeshare_folderkeys` (
  `folder_id` bigint(20) unsigned NOT NULL,
  `user_uid` varchar(254) COLLATE utf8mb4_bin NOT NULL,
  `key_id` varchar(32) COLLATE utf8mb4_bin NOT NULL,
  `created` int(10) unsigned NOT NULL,
  KEY `e2ee_folderkeys_folder` (`folder_id`),
  KEY `e2ee_folderkeys_user` (`user_uid`),
  KEY `e2ee_folderkeys_userkey` (`user_uid`,`key_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin ROW_FORMAT=COMPRESSED

CREATE TABLE `oc_e2eeshare_keys` (
  `user_uid` varchar(254) COLLATE utf8mb4_bin NOT NULL,
  `key_id` varchar(32) COLLATE utf8mb4_bin NOT NULL,
  `public_key` text COLLATE utf8mb4_bin NOT NULL,
  `ip` varchar(45) COLLATE utf8mb4_bin NOT NULL,
  `user_agent` text COLLATE utf8mb4_bin,
  `created` int(10) unsigned NOT NULL,
  `description` text COLLATE utf8mb4_bin,
  KEY `e2ee_user_uid_index` (`user_uid`),
  KEY `e2ee_key_id_index` (`key_id`),
  KEY `e2ee_user_key_index` (`user_uid`,`key_id`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin ROW_FORMAT=COMPRESSED

CREATE TABLE `oc_e2eeshare_shares` (
  `fileid` bigint(20) unsigned NOT NULL,
  UNIQUE KEY `e2ee_fileid_index` (`fileid`)
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COLLATE=utf8mb4_bin ROW_FORMAT=COMPRESSED