Docker

How to use goshs with docker

Official goshs images are published to two registries on every release. Both are multi-arch and run natively on linux/amd64 and linux/arm64 (Intel/AMD as well as Apple Silicon, Raspberry Pi and ARM cloud instances):

Pull from Docker Hub:

docker pull goshslabs/goshs

…or from GHCR (handy if you hit Docker Hub’s anonymous pull rate limits):

docker pull ghcr.io/goshs-labs/goshs

Both registries provide a latest tag as well as a tag for every release version (e.g. goshslabs/goshs:v2.1.1 or ghcr.io/goshs-labs/goshs:v2.1.1).

And then use it like:

docker run --rm -it -p 8000:8000 -v "$PWD:/pwd" goshslabs/goshs:latest -d /pwd

The exact same invocation works with the GHCR image:

docker run --rm -it -p 8000:8000 -v "$PWD:/pwd" ghcr.io/goshs-labs/goshs:latest -d /pwd
Info

Make sure to point -v to the directory you want to expose and adjust -p if you are changing the default port.

Warning

Files will be uploaded to /root inside the container and will not be accessible via the mounted volume, unless you specify -uf /pwd to match the folder specified with -d.