Stash-Docs/docs/installation/docker.md

title, icon

title	icon
Docker	fontawesome/brands/docker

!!! info Before starting make sure your system has Docker installed. You can follow the instructions on how to install Docker from Docker Docs{:target="_blank"}.

!!! info Official Stash image is located at stashapp/stash{:target="_blank"}.

!!! note Stash README on Docker installation is available here{:target="_blank"}.

Using Docker Compose

Install

1. Download and save docker-compose.yml file from our GitHub{:target="_blank"}.

• Modify the docker-compose.yml file to your preferences.

2. Open terminal in the same directory as saved docker-compose.yml or cd to that directory.
3. Run docker-compose up -d
4. Installing this way will bound Stash to port 9999.
5. If everything went well Stash will be available at http://localhost:9999{:target="_blank"} locally or on your network http://YOUR-LOCAL-IP:9999{:target="_blank"}.

Update

??? warning If you are upgrading from older than v0.20 version make sure to re-download the docker-compose.yml file from our GitHub{:target="_blank"} as new volume was added. Alternatively you can edit the docker-compose.yml to manually include new volume - ./blobs:/blobs.

1. Go to the directory where docker-compose.yml is saved.
2. Run docker-compose pull. Pulls the new image.
3. Run docker-compose down. Removes old container.
4. Run docker-compose up -d. Creates and starts the new container.

• Make sure the mount points and settings are the same as in previous docker-compose.yml file.

Remove

1. Go to the directory where docker-compose.yml is saved.
2. Run docker container kill. Force stops the container.
3. Run docker container rm. Removes the container.
4. Delete docker-compose.yml file.