vh/rest-server
1
0
Fork 0
mirror of https://github.com/restic/rest-server.git synced 2025-12-07 01:26:18 -08:00
Code Issues Actions 1 Packages Projects Releases Wiki Activity

Clarification of docker section in README.md

Browse Source 
Refs #128, the two distinct docker sections of the README are merged into one.
This commit is contained in:
Marc Fargas
2021-10-28 13:37:18 +00:00
parent 9f8c31b968
commit 12cf4bbc05
1 changed files with 20 additions and 28 deletions
Download Patch File Download Diff File Expand all files Collapse all files

48
README.md
View File

@@ -19,28 +19,6 @@ The required version of restic backup client to use with `rest-server` is [v0.7.
For building the `rest-server` binary run `CGO_ENABLED=0 go build -o rest-server ./cmd/rest-server`
## Docker
### Build image
The docker image build process will build a fresh version of the rest-server and package that into
a usable container.
To build the binary along with the container run:
```sh
docker build -t restic/rest-server:latest .
```
### Pull image
```sh
docker pull restic/rest-server
```
## Usage
To learn how to use restic backup client with REST backend, please consult [restic manual](https://restic.readthedocs.io/en/latest/030_preparing_a_new_repo.html#rest-server).
@@ -111,19 +89,33 @@ There's an example [systemd service file](https://github.com/restic/rest-server/
### Docker
By default, image uses authentication. To turn it off, set environment variable `DISABLE_AUTHENTICATION` to any value.
Persistent data volume is located to `/data`.
Rest Server works well inside a container, images are [published to Docker Hub](https://hub.docker.com/r/restic/rest-server).
#### Start server
You can run the server with any container runtime, like Docker:
```sh
docker run -p 8000:8000 -v /my/data:/data --name rest_server restic/rest-server
docker pull restic/rest-server:latest
docker run -p 8000:8000 -v /my/data:/data --name rest_server restic/rest-server
```
It's suggested to set a container name to more easily manage users (see next section).
Note that:
You can set environment variable `OPTIONS` to any extra flags you'd like to pass to rest-server.
- **contrary to the defaults** of `rest-server`, the persistent data volume is located to `/data`.
- By default, the image uses authentication. To turn it off, set environment variable `DISABLE_AUTHENTICATION` to any value.
- It's suggested to set a container name to more easily manage users (`--name` parameter to `docker run`).
- You can set environment variable `OPTIONS` to any extra flags you'd like to pass to rest-server.
#### Customize the image
The [published image](https://hub.docker.com/r/restic/rest-server) is built from the `Dockerfile` available on this repository, which you may use as a basis for building your own customized images.
```sh
git clone https://github.com/restic/rest-server.git
cd rest-server
docker build -t restic/rest-server:latest .
```
#### Manage users