https://github.com/zimme/docker-rar2fs

https://github.com/zimme/docker-rar2fs

alpine docker fuse rar2fs

Last synced: 12 days ago
JSON representation

• Host: GitHub
• URL: https://github.com/zimme/docker-rar2fs
• Owner: zimme
• Created: 2019-01-14T16:22:38.000Z (almost 6 years ago)
• Default Branch: main
• Last Pushed: 2023-12-08T22:57:21.000Z (12 months ago)
• Last Synced: 2024-10-19T15:16:03.217Z (about 1 month ago)
• Topics: alpine, docker, fuse, rar2fs
• Language: Dockerfile
• Homepage:
• Size: 62.5 KB
• Stars: 15
• Watchers: 4
• Forks: 2
• Open Issues: 1
• Metadata Files:
  • Readme: README.md

Awesome Lists containing this project

README

        
# zimme/rar2fs

Minimal [`rar2fs`] image based on alpine.

The image will run `rar2fs` with `-o allow_other -o auto_unmount

--seek-length=1` by default.

Bind-mount your rar files on `/source` and bind-mount an empty folder on

`/destination` to hold the rar2fs mount, and make sure you set the

bind-propagation to `shared`/`rshared`.

The image will run `rar2fs` as `root`. I recommend overriding this

using the `-u` and/or `--group-add` flags of docker run.

I recommend using `--init` when running this image.

You will need to add capabilities `MKNOD` and `SYS_ADMIN` as well as

providing the `/dev/fuse` device to the container for it to be able to

mount a fuse fs like rar2fs.

If your docker host is using `apparmor` the following flag,

`--security-opt apparmor:unconfined`, might be needed to have

permission to use fuse within the container.

## Usage

```sh

docker run \

  -d \

  --init \

  --name rar2fs \

  --cap-add MKNOD \

  --cap-add SYS_ADMIN \

  --device /dev/fuse \

  --network none \

  -v :/source \

  -v :/destination:rshared \

  zimme/rar2fs

```

## Config

To get a list of all config options for `rar2fs` run the following

command.

```sh

docker run --rm zimme/rar2fs --help

```

To run this image with your own config provide your config arguments as

arguments to the image when running.

```sh

docker run \

  -d \

  --init \

  --name rar2fs \

  --cap-add MKNOD \

  --cap-add SYS_ADMIN \

  --device /dev/fuse \

  --network none \

  -v :/source \

  -v :/destination:rshared \

  zimme/rar2fs \

   \

  -o  \

  /source \

  /destination

```

## Docker Compose

You can find an example of a docker-compose file [here][docker-compose.yml].

[docker-compose.yml]: https://github.com/zimme/docker-rar2fs/blob/master/docker-compose.example.yml

[`rar2fs`]: https://github.com/hasse69/rar2fs