mirror of
https://github.com/nkanaev/yarr.git
synced 2025-05-25 13:39:22 +00:00
Update readme.md
Add additional instructions for deploying with Docker.
This commit is contained in:
parent
9d5b8d99f7
commit
e618d5a4e2
72
readme.md
72
readme.md
@ -12,6 +12,29 @@ The app is a single binary with an embedded database (SQLite).
|
|||||||
The latest prebuilt binaries for Linux/MacOS/Windows AMD64 are available
|
The latest prebuilt binaries for Linux/MacOS/Windows AMD64 are available
|
||||||
[here](https://github.com/nkanaev/yarr/releases/latest). Installation instructions:
|
[here](https://github.com/nkanaev/yarr/releases/latest). Installation instructions:
|
||||||
|
|
||||||
|
* Command Arges
|
||||||
|
|
||||||
|
```
|
||||||
|
-addr string
|
||||||
|
address to run server on (default "127.0.0.1:7070")
|
||||||
|
-auth-file path
|
||||||
|
path to a file containing username:password
|
||||||
|
-base string
|
||||||
|
base path of the service url
|
||||||
|
-cert-file path
|
||||||
|
path to cert file for https
|
||||||
|
-db path
|
||||||
|
storage file path
|
||||||
|
-key-file path
|
||||||
|
path to key file for https
|
||||||
|
-log-file path
|
||||||
|
path to log file to use instead of stdout
|
||||||
|
-open
|
||||||
|
open the server in browser
|
||||||
|
-version
|
||||||
|
print application version
|
||||||
|
```
|
||||||
|
|
||||||
* MacOS
|
* MacOS
|
||||||
|
|
||||||
Download `yarr-*-macos64.zip`, unzip it, place `yarr.app` in `/Applications` folder, [open the app][macos-open], click the anchor menu bar icon, select "Open".
|
Download `yarr-*-macos64.zip`, unzip it, place `yarr.app` in `/Applications` folder, [open the app][macos-open], click the anchor menu bar icon, select "Open".
|
||||||
@ -27,12 +50,53 @@ and run [the script](etc/install-linux.sh).
|
|||||||
|
|
||||||
[macos-open]: https://support.apple.com/en-gb/guide/mac-help/mh40616/mac
|
[macos-open]: https://support.apple.com/en-gb/guide/mac-help/mh40616/mac
|
||||||
|
|
||||||
For self-hosting, see `yarr -h` for auth, tls & server configuration flags.
|
* Docker environment
|
||||||
|
|
||||||
See more:
|
You can use docker or docker-compose to run yarr, and you can also use environment variables to configure startup parameters.
|
||||||
|
|
||||||
* [Building from source code](doc/build.md)
|
- `YARR_ADDR` :address to run server on (default "127.0.0.1:7070")
|
||||||
* [Fever API support](doc/fever.md)
|
- `YARR_BASE` :base path of the service url
|
||||||
|
- `YARR_AUTHFILE` :path to a file containing username:password
|
||||||
|
- `YARR_CERTFILE` :path to cert file for https
|
||||||
|
- `YARR_KEYFILE` :path to key file for https
|
||||||
|
- `YARR_DB` :storage file path
|
||||||
|
- `YARR_LOGFILE` :path to log file to use instead of stdout
|
||||||
|
|
||||||
|
* Docker run:
|
||||||
|
```
|
||||||
|
docker run -d \
|
||||||
|
--name yarr \
|
||||||
|
-p 25255:7070 \
|
||||||
|
-e YARR_AUTHFILE="/data/.auth.list" \
|
||||||
|
-v /data/yarr-data:/data \
|
||||||
|
--restart always \
|
||||||
|
arsfeld/yarr:latest
|
||||||
|
```
|
||||||
|
|
||||||
|
* Docker-Compose Run
|
||||||
|
|
||||||
|
Create a file named `.auth.list` under the `/data/` directory, and the content format should be: `username:password`.
|
||||||
|
Then start by running docker-compose up -d and enjoy!
|
||||||
|
|
||||||
|
```yaml
|
||||||
|
version: '3.3'
|
||||||
|
services:
|
||||||
|
yarr:
|
||||||
|
container_name: yarr
|
||||||
|
image: 'arsfeld/yarr:latest'
|
||||||
|
restart: always
|
||||||
|
ports:
|
||||||
|
- '25255:7070'
|
||||||
|
environment:
|
||||||
|
YARR_AUTHFILE: "/data/.auth.list"
|
||||||
|
volumes:
|
||||||
|
- '/data/yarr-data:/data'
|
||||||
|
```
|
||||||
|
|
||||||
|
* See more:
|
||||||
|
|
||||||
|
* [Building from source code](doc/build.md)
|
||||||
|
* [Fever API support](doc/fever.md)
|
||||||
|
|
||||||
## credits
|
## credits
|
||||||
|
|
||||||
|
Loading…
x
Reference in New Issue
Block a user