Sign inSign up

antlafarge/http-share

By antlafarge

•Updated over 1 year ago

Share a directory through HTTP (protected by htaccess password) by using nginx.

Image
Web servers
0

3.1K

antlafarge/http-share repository overview

⁠HTTP-SHARE

Share a directory through HTTP (protected by htaccess password) by using nginx.

⁠Docker

# Create the login/password to access the http share.
echo "<LOGIN>:$(perl -le 'print crypt("<PASSWORD>", "1xzcq")')" > ~/http-share.htpasswd

docker run -d \
        --name <CONTAINER-NAME> \
        --restart <RESTART> \
    -v <PATH>:/usr/share/nginx/html/<SHARE-NAME>:ro \
    -v ~/http-share.htpasswd:/etc/nginx/conf.d/.htpasswd:ro \
        -p <PORT>:80 \
    antlafarge/http-share:latest

Parameters indented twice are optional.

  • Replace <LOGIN> and <PASSWORD> by the login and password which will be required to access the http share.
  • Replace <CONTAINER-NAME> by the name you want for the container.
  • Replace <RESTART> by on-failure, unless-stopped or always.
  • Replace <PORT> by the http port you will open in your router NAT.
  • Replace <PATH> by the absolute path to the directory you want to share and <SHARE-NAME> by the name you want for the shared directory. The share-name is optional if you need to share only 1 directory. You can add many volumes if you want to share multiple directories (see examples).

Note : Do not delete the file http-share.htpasswd on your host machine, it will be used by the container.

⁠Example
# Create the login/password to access the http share.
echo "admin:$(perl -le 'print crypt("MyGreatPassword", "1xzcq")')" > ~/http-share.htpasswd

docker run -d \
        --name http-share \
        --restart on-failure:2 \
    -v "/mnt/hdd/public:/usr/share/nginx/html/Public:ro" \
    -v "/mnt/hdd/shared:/usr/share/nginx/html/Shared:ro" \
    -v "~/http-share.htpasswd:/etc/nginx/conf.d/.htpasswd:ro" \
        -p 8080:80 \
    antlafarge/http-share:latest

Parameters indented twice are optional.

⁠Docker compose

echo "<LOGIN>:$(perl -le 'print crypt("<PASSWORD>", "1xzcq")')" > ~/http-share.htpasswd

services:
    http-share:
        image: antlafarge/http-share:latest
        container_name: <CONTAINER-NAME> # optional
        restart: <RESTART> # optional
        volumes:
            - "<PATH>:/usr/share/nginx/html/<SHARE-NAME>:ro"
            - "~/http-share.htpasswd:/etc/nginx/conf.d/.htpasswd:ro"
        ports:
            - "<PORT>:80" # optional
⁠Example
echo "admin:$(perl -le 'print crypt("MyGreatPassword", "1xzcq")')" > ~/http-share.htpasswd

services:
    http-share:
        image: antlafarge/http-share:latest
        container_name: http-share # optional
        restart: on-failure:2 # optional
        volumes:
            - "/mnt/hdd/public:/usr/share/nginx/html/Public:ro"
            - "/mnt/hdd/shared:/usr/share/nginx/html/Shared:ro"
            - "~/http-share.htpasswd:/etc/nginx/conf.d/.htpasswd:ro"
        ports:
            - "8080:80" # optional

⁠Docker commands reminder

⁠Container stop
docker stop http-share
⁠Container restart
docker restart http-share
⁠Container logs
docker logs --follow --tail 100 http-share
⁠Container delete
docker rm -f http-share
⁠Image delete
docker rmi antlafarge/http-share:latest
⁠Compose start
cd /path/to/docker-compose.yml/directory/
docker compose up -d
⁠Compose stop
cd /path/to/docker-compose.yml/directory/
docker compose down

Tag summary

Content type

Image

Digest

sha256:3a87ac65d…

Size

19.1 MB

Last updated

over 1 year ago

docker pull antlafarge/http-share