mirror of
https://github.com/filebrowser/filebrowser.git
synced 2025-05-10 04:02:57 +00:00
071c825f76
Former-commit-id: faad2923558f5d3d3f68f972f46591149eaa6e6f [formerly ea7247ded4bf78fac84ac4d2f6896236c0a96792] [formerly 57b440d1cf2aaf67a6f0837088e984524eb44a8b [formerly 73c92ac134481af259c2720e7df662d2c5e50f50]] Former-commit-id: 2b52e6a992a4e93e02fb807a2a20a2e77f2ce629 [formerly 50f273843a2febce7d30b9e23233d1b88dfec2d6] Former-commit-id: 26cb7f4f4dac22f959d428531e3515bf4000415e
53 lines
2.0 KiB
Markdown
53 lines
2.0 KiB
Markdown
# filemanager - a caddy plugin
|
|
|
|
filemanager provides WebDAV features and a file managing interface within the specified directory and it can be used to upload, delete, preview, rename and edit your files within that directory. It is an implementation of [hacdias/filemanager](https://github.com/hacdias/filemanager) library.
|
|
|
|
Note that if you are handling large files you might run into troubles due to the defaults of [`timeouts`](https://caddyserver.com/docs/timeouts) plugin. Check its [documentation](https://caddyserver.com/docs/timeouts) to learn more about that plugin.
|
|
|
|
For information about the working of filemanager itself, go to the [main repository](https://github.com/hacdias/filemanager).
|
|
|
|
## Get Started
|
|
|
|
To start using this plugin you just need to go to the [download Caddy page](https://caddyserver.com/download) and choose `filemanager` in the directives section. For further information on how Caddy works refer to [its documentation](https://caddyserver.com/docs).
|
|
|
|
## Syntax
|
|
|
|
```
|
|
filemanager [baseurl] [scope] {
|
|
database path
|
|
}
|
|
```
|
|
|
|
All of the options above are optional.
|
|
|
|
+ **baseurl** is the URL where you will access the File Manager interface. Defaults to `/`.
|
|
+ **scope** is the path, relative or absolute, to the directory you want to browse in. Defaults to `./`.
|
|
+ **path** is the database path where File Manager will store the settings that aren't included in the Caddyfile. By default, the database will be stored on `.caddy` folder and its name will be an hashed combination of the host and the `baseurl`. It is **highly** recommended to set this option. Otherwise, whenever you change the host or the baseurl, your settings will be lost or you will need to point to the previous database.
|
|
|
|
## Examples
|
|
|
|
Show the directory where Caddy is being executed at the root of the domain:
|
|
|
|
```
|
|
filemanager
|
|
```
|
|
|
|
|
|
Show the content of `foo` at the root of the domain:
|
|
|
|
```
|
|
filemanager / ./foo
|
|
```
|
|
|
|
Show the directory where Caddy is being executed at `/filemanager`:
|
|
|
|
```
|
|
filemanager /filemanager
|
|
```
|
|
|
|
Show the content of `foo` at `/bar`:
|
|
|
|
```
|
|
filemanager /bar /show
|
|
```
|