Tags Drive

Tags Drive is an open source standalone cloud drive. The main feature of Tags Drive is no folders. Instead, every file can have a tag (or tags).

---

• Why I should prefer Tags Drive to other cloud drives
• Installation
  • Requirements
  • Running
  • Proxy example
• FAQ
  • What is the View Mode
  • How to upload new files
  • How to preview files
  • How to search files
  • How to select multiple files
  • How to manage files
  • Can I share files
  • Trash
  • Other
• Infrastructure

Why I should prefer Tags Drive to other cloud drives

For example, you want to save an image of a cat. You can save it into folder cats or into folder cute. Of course, you may keep 2 equal files, but it would be better to use the tags system. So, you just should to add tags cat and cute to the photo.

Installation

Requirements

• Docker

Running

1. Pull the latest release from Docker Hub

   docker pull kirtis/tags-drive:latest

2. Prepare folders

   Create a folder tags-drive and several sub-folders:

   • var
   • ssl (if you want to use HTTPS)

   CD to tags-drive folder.

3. Create an env file and a script to run a docker container

   Env file – tags-drive.env

   WEB_LOGIN=user
   WEB_PASSWORD=qwerty
   WEB_TLS=true
   STORAGE_ENCRYPT=true

   List of all env variables

   Script – run.sh

   #!/bin/bash
   
   docker run --rm -d \
     --name tags-drive \
     -p 80:80 \
     -v $PWD/var:/app/var \
     -v $PWD/ssl:/app/ssl \
     --env-file $PWD/tags-drive.env \
     kirtis/tags-drive:latest

4. Generate a self-signed TLS certificate (optional)

   openssl req -x509 -nodes -newkey rsa:2048 -sha256 -keyout ./ssl/key.key -out ./ssl/cert.cert

5. Run run.sh script

Proxy example

You can use Caddy to proxy requests to Tags Drive.

1. Replace -p 80:80 with -p 127.0.0.1:80:80 to expose Tags Drive only to the host

2. Disable TLS (set WEB_TLS variable to false)

3. Create Caddyfile

   tags-drive.example.com {
     proxy / localhost:80 {
       transparent
     }
   
     gzip
   
     log logs/tags-drive.example.log {
       rotate_age 5 # days
       except /favicon.ico
     }
   }
   

4. Run caddy

FAQ

What is the View Mode

There're 2 View Modes:

• Cards
• List

You can switch them in Settings

How to upload new files

You can upload new files with Drag and Drop

How to preview files

You can open the Preview Window with click on a file image. You can switch previews by arrows.

How to search files

Tags Drive provides search with logical expression. You can use logical operators:

• ! – logical NOT
• & – logical AND
• | – logical OR
• (, )

For example, you have tags with id 1, 5, 23. You want to find files with tags 1 and 5 and without 23, but files must not have tags 1 and 5 at the time. You can use next search request: !(1&5)&!23

Additional information about logical algebra on Wikipedia: Boolean algebra

How to select multiple files

You can select multiple files with Ctrl+Left Button

How to manage files

You can open Context Menu on Right Button.

Can I share files

Yes, you can share files from Context Menu. You can manage Share Tokens from Settings.

Trash

There are 2 ways to delete a file

• Trash: you can move a file into Trash. Then file will be deleted after 1 week.

• Force delete: you can delete a file immediately

Other

• You can keep files with same filenames
• You can tag files before upload on Upload Window
• You can sort files by name, size and adding time

Infrastructure

There are several repositories:

• tags-drive/core - contains backend part (written in Go)
• tags-drive/web - contains web part (written in Vue.js and TypeScript)