Julio Biason
5 years ago
1 changed files with 31 additions and 0 deletions
@ -0,0 +1,31 @@ |
|||||||
|
# NC-DIRS |
||||||
|
|
||||||
|
## What is this? |
||||||
|
|
||||||
|
When you're using [NextCloud](https://nextcloud.com/) (the "nc" part of the |
||||||
|
name of this) and you're using an object store (like [AWS |
||||||
|
S3](https://aws.amazon.com/s3/) or [Digital Ocean |
||||||
|
Spaces](https://www.digitalocean.com/products/spaces/)), it will need some |
||||||
|
special files, marked with content-type "unix/http-directory" to understand |
||||||
|
directories; when those files are missing, NextCloud will not show the |
||||||
|
directories. |
||||||
|
|
||||||
|
Uploading files directly from the NextCloud interface will create those files, |
||||||
|
but you use some other tool, like [s3cmd](https://s3tools.org/s3cmd), for |
||||||
|
example, those files will be missing. |
||||||
|
|
||||||
|
`nc-dirs` will scan the object store and add the missing "directory" files. |
||||||
|
|
||||||
|
## Running |
||||||
|
|
||||||
|
To run, you'll need some environment variables: |
||||||
|
|
||||||
|
* `NC_REGION` with the region name. |
||||||
|
* `NC_ENDPOINT` with the storage endpoint. |
||||||
|
* `NC_BUCKET` with the bucket name you want to scan and ensure the files are |
||||||
|
there. |
||||||
|
* `NC_ACCESS_KEY` with the access key to access the bucket. |
||||||
|
* `NC_SECRET_KEY` with the secret key to access the bucket. |
||||||
|
|
||||||
|
(`NC_ENDPOINT` may seem redundant if you're using AWS S3, but as a Digital |
||||||
|
Ocean Spaces client, I need that to be able to access it properly.) |
Loading…
Reference in new issue