Files
Axter-Stash/Docker/README.md
David Maisonave a85de44b15 Update README.md
2025-01-06 02:44:07 -05:00

53 lines
3.0 KiB
Markdown

# Create Docker Stash Container (By David Maisonave)
CreateContainer.cmd is a Windows script that is used to create a Stash container on Docker.
To use it, first copy the file to the following path:
`C:\Users\MyUserName\AppData\Local\Docker\wsl\CreateContainer.cmd`
Note: Replace **MyUserName** with the actual user name.
Then use a DOS window to change to the **ws1** directory before calling the script.
### The script requires at minumum 3 arguments.
- New Container Name
- Image Name
- Stash Port Number
### Example Commands:
- Example usage with minumum arguments:
- `CreateContainer.cmd MyContainerName "stashapp/stash:latest" 9998`
- Example adding Stash **Image** and container:
- `CreateContainer.cmd MyStashContainer "stashapp/stash:latest" 9997 IMAGE`
- Example with shared mount paths:
- `CreateContainer.cmd NewContainer27.2 "stashapp/stash:v0.27.2" 9991 C:\MySharedMountPath C:\Another\Shared\Folder`
- Example with shared mount paths with write access:
- `CreateContainer.cmd ContainerName1 "stashapp/stash:latest" 9991 C:\MyShared WRITE`
- Example with DLNA:
- `CreateContainer.cmd MyDLNA272 "stashapp/stash:v0.27.2" 9996 C:\downloads DLNA`
- Example skipping docker-compose:
- `CreateContainer.cmd ContainerName "stashapp/stash:v0.26.2" 9992 C:\Videos SKIP`
### Shared Mount Paths
- CreateContainer.cmd can create 1-5 shared mount paths on the container. A shared mount path is a path that is a HOST path that is mounted on the container, which allows the container to access the files in the shared mount path.
- By default the shared mount is READ-ONLY, but by appending **WRITE** to the command line, the script will make all the shared mounts with read-write access.
- Example: `CreateContainer.cmd ContainerName1 "stashapp/stash:latest" 9999 C:\MySharedMountPath WRITE`
### DLNA Functionality
- The script can create a Stash container with DLNA Functionality. To add DLNA Functionality, append **DLNA** to the command line.
- Example:`CreateContainer.cmd v272 "stashapp/stash:v0.27.2" 9996 DLNA`
### Skip docker-compose
- By default, `docker-compose up -d` is called after the script creates the **docker-compose.yml** file. To skip this call, append SKIP to the command line.
- Example: `CreateContainer.cmd ContainerName "stashapp/stash:v0.26.2" 9992 SKIP`
- When SKIP is used, the script only creates the container directory and creates the **docker-compose.yml** file in the newly created directory.
- This option is mainly used for debugging purposes.
### Downloads
- Docker
- Use the following link to download Docker
- [https://www.docker.com/products/docker-desktop/](https://www.docker.com/products/docker-desktop/)
- Stash Image
- The CreateContainer.cmd script can download the Image before creating the container by adding **IMAGE** at the end of the command line.
- Example: `CreateContainer.cmd ver0272 "stashapp/stash:v0.27.2" 9999 IMAGE`
- To see what Stash images are available, see the following link: [https://hub.docker.com/r/stashapp/stash/tags](https://hub.docker.com/r/stashapp/stash/tags).