any plans for docker and docker compose support?

[aniel300]

any plans to support docker and docker compose support?

[rejetto]

i'm not sure what is needed for docker as i'm no docker user myself, but i tried to write a few instructions here https://github.com/rejetto/hfs/wiki/Docker/
feel free to edit the page if you have any contribution.
i know @damienzonly is working on something.

[aniel300]

perfect can't wait to test it out

[Jarusz]

Is there any chance for a docker-compose instructions? something similar what linuxserver gives, for example https://hub.docker.com/r/linuxserver/plex where i could just specify paths to the folders which i want to share etc, that would be such a great thing, for those of us who arent that great with docker

[aniel300]

am in the same boat. @damienzonly can u help on this?

[aniel300]

this is what https://www.composerize.com/ gives me but am not sure if this would work

[aniel300]

i was able to get it up and running with this but now am unable to ssh into the container to run the admin command. here are some screenshots

[damienzonly]

yep, i'm working on having docker support, the first step is to have a working dockerfile, then i'll see what env variables i may support, for example to let you create the first admin user, configure the http/https port, etc.. i'll keep you updated

[aniel300]

yep, i'm working on having docker support, the first step is to have a working dockerfile, then i'll see what env variables i may support, for example to let you create the first admin user, configure the http/https port, etc.. i'll keep you updated

that is awesome. am not worried about https since i have my own reverse proxy up and running which takes care of https and ssl certs. but yes please do keep me updated 🙏

[damienzonly]

Hi @aniel300, thanks for the interest. I've been working a little bit on the docker support and for now there's only one image rejetto/hfs:0.52.7, not well documented, it should work fine and also allowing you to configure stuff via env (see this file for envs reference.
There are other priorities and discussions to make in order to deliver HFS in docker, i'll keep you updated, in the meantime you can try the image out and let me know if you have any issues

[aniel300]

thank you for getting back to me and can't wait to test this out and report back. also can u share how ur compose file is looking so i can use it as reference?

[damienzonly]

@aniel300 @Jarusz hi guys, the official docker images are out https://hub.docker.com/r/rejetto/hfs, i also provided the docker run command and an example of compose file. let me know if it works. Feel free to open issues here https://github.com/damienzonly/hfs-docker/issues

[aniel300]

correct however this is dependent on the container as 95 of my containers uses my user for the folder creation. here is a screenshot of how it looks

[damienzonly]

i need some additional info about the way you are running hfs in docker. while testing this system i always used an unprivileged user, still now i'm re-doing the tests and docker never creates a directory on the host owned by root.
what's the command you use to run the container?
do you use compose?
which version of docker do you have?
i have no idea why this is happening to you, the more info you provide, the more easy will be the troubleshooting for me

[aniel300]

of course I will try rpovide any info u mi0ght need

here is my docker version and yes am using docker compose. here is also my docker compose.
`Client: Docker Engine - Community
Version: 27.1.1
API version: 1.46
Go version: go1.21.12
Git commit: 6312585
Built: Tue Jul 23 19:57:19 2024
OS/Arch: linux/amd64
Context: default

Server: Docker Engine - Community
Engine:
Version: 27.1.1
API version: 1.46 (minimum version 1.24)
Go version: go1.21.12
Git commit: cc13f95
Built: Tue Jul 23 19:57:19 2024
OS/Arch: linux/amd64
Experimental: false
containerd:
Version: 1.7.19
GitCommit: 2bf793ef6dc9a18e00cb12efb64355c2c9d5eb41
runc:
Version: 1.7.19
GitCommit: v1.1.13-0-g58aa920
docker-init:
Version: 0.19.0
GitCommit: de40ad0
`

hfs:
image: rejetto/hfs:v0.53.0
container_name: hfs
volumes:
- $PERSIST/hfs:/home/hfs/.hfs # for hfs conf persistence
- /data:/app/myDisk # for your files
# don't forget to share volumes to access certificate files
environment:
- PUID=$PUID
- PGID=$PGID
- TZ=$TIME_ZONE
- HFS_PORT=8080 # default is 80
- HFS_CREATE_ADMIN=xxx # will create the admin user with password "password123"
ports:
- 8080:8080

[damienzonly]

i'm not sure what you're trying to accomplish by providing puid and pgid, try removing them and see if the error persists. i don't know the purpose of those variables, anyway it may be messing with permissions. fyi the official docker image uses the "hfs" user created on puropose to execute hfs without root permissions. let me know what was your objective

[aniel300]

there is no objective on my part, i included the ppgid as a ts. it didn't work without it. idk what else to do

[bmartino1]

Hi Rejetto, Long time no see. I will take a crack at it.

atm i will be building a docker file in the github and make a docker iamge...

here is an example of the docker file:

# Use the Debian-based GUI image for VNC support
FROM jlesage/baseimage-gui:debian-12-v4.6.4 AS base

# Set environment variables
ENV NODE_VERSION=18

# Update packages and install prerequisites
RUN apt-get update && \
    apt-get install -y curl gnupg2 lsb-release software-properties-common wget && \
    rm -rf /var/lib/apt/lists/*

# Install Node.js version 18
RUN curl -fsSL https://deb.nodesource.com/setup_$NODE_VERSION.x | bash - && \
    apt-get install -y nodejs && \
    rm -rf /var/lib/apt/lists/*

# Create a new user to run the HFS application
RUN addgroup --system hfs && \
    adduser --system --ingroup hfs hfs

# Switch to non-root user
USER hfs

# Set up HFS
RUN npm install -g npx

# Run HFS using npx on container start
CMD ["npx", "hfs@latest"]

# Expose port for HFS access
EXPOSE 8080

# Finalize the VNC configuration (adding a browser)
USER root
RUN apt-get update && \
    apt-get install -y firefox-esr && \
    rm -rf /var/lib/apt/lists/*

# Set default environment variables for VNC
ENV APP_NAME="HFS with VNC"
ENV RUN_AS_USER="hfs"

# Start HFS with VNC viewer enabled
ENTRYPOINT ["/init"]

the plan is a docker with vnc / firefox to view the admin interface.

Volumes
the a docker mount for data /data
and a dokcer mount for the .vfs hfs config files..

I want a docker with a vnc web view:
FROM jlesage/baseimage-gui:debian-12-v4.6.4 AS download

So lets use debain. I will need a web browser to access the application in it.
I will need to pull form these site too:
https://docs.docker.com/guides/nodejs/containerize/
https://github.com/nodejs/docker-node
Form The Hub: https://hub.docker.com/_/node/tags

It will take me a while to get to completion. I will be useing your other setup per the github... but here is a sample...
https://github.com/bmartino1/Docker_VNC_RejetoHFS

[damienzonly]

hi @bmartino1, we've already deployed official hfs images on rejetto's docker registry.
did you check them out?
the repository for images build process is at https://github.com/damienzonly/hfs-docker

[rejetto]

hi @bmartino1, happy to see you again :)

[bmartino1]

Thank you for this. I didn't know if it existed. I will check that out now.

…

On Tue, Oct 29, 2024 at 9:34 PM damienzonly ***@***.***> wrote: hi @bmartino1 <https://github.com/bmartino1>, we've already deployed official hfs images on rejetto's docker registry. did you check them out? the repository for images build process is at https://github.com/damienzonly/hfs-docker — Reply to this email directly, view it on GitHub <#551 (reply in thread)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BH42CTQE76JJ76A2AMROLZTZ6BAU5AVCNFSM6AAAAABGRTKRFKVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTCMBZGQ2TCNI> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[bmartino1]

Hi, Just wanted to let you know that I will attempt to expand your audience on another platform. https://github.com/bmartino1/unraid-docker-templates I wanted to give Thanks to Both Rejetto and Thanks to damienzonly for starting me on the right path: I originally attempted to fork damienzonly Repo. Decided to clone separate due to some core changes needed specficaly for unriad. that repo can be found here. https://github.com/bmartino1/hfs-docker With a working docker compose on unraid Linux Slackware Docker System. I have successfully added your app to a Unraid Point and Click Appstore. https://github.com/bmartino1/unraid-docker-templates [image: image.png] Which will allow unraids users to use your application on the Unraid Platform in docker format. [image: image.png] I will attempt to follow and maintain this to your standards. Thank you both!

…

Message ID: ***@***.*** com>

[rejetto]

I never used unraid, but this sounds like a cool project :)
if you need an updated HFS icon, here it is
hfs-logo-icon.svg.zip

[bmartino1]

Awesome, thanks! I will update that Unraid use png images: https://raw.githubusercontent.com/bmartino1/unraid-docker-templates/refs/heads/main/images/rejettohfs.png

…

On Sun, Nov 3, 2024 at 4:07 PM Massimo Melina ***@***.***> wrote: I never used unraid, but this sounds like a cool project :) if you need an updated HFS icon, here it is hfs-logo-icon.svg (view on web) <https://github.com/user-attachments/assets/9d2e9542-27a6-45d2-8ed7-3babf76639cc> — Reply to this email directly, view it on GitHub <#551 (comment)>, or unsubscribe <https://github.com/notifications/unsubscribe-auth/BH42CTSGPOMWSJ4LIBXQXL3Z62NBJAVCNFSM6AAAAABGRTKRFKVHI2DSMVQWIX3LMV43URDJONRXK43TNFXW4Q3PNVWWK3TUHMYTCMJTGY4DSMA> . You are receiving this because you were mentioned.Message ID: ***@***.***>

[patschi]

FWIW, I have just made my own docker-build project for HFS, which is completely differing from the current available repo(s): https://github.com/patschi/hfs-docker. One reason being that I have not found latest 0.54.0 in the other docker project and found it too 'bloaty' even with Alpine.

The major difference is, that it uses the pre-compiled binaries from this repo. Hence, building containers is way less sensitive to errors and quicker compared to compiling.

It's completely automated for all HFS releases (via API and includes prereleases/beta/RCs; without any requirement for user intervention) and uses the distroless container base image by Google, which is way smaller, secure and contains no extra 'junk' as others even compared to alpine.

I have let it built the last 20 releases, should anyone ever want to pick a older release. The latest stable release in this main hfs-repo is always automatically tagged as latest.

[aniel300]

will take a look, thanks