stashapp/compiler
StashApp compiler container for the Stash app itself.
10K+
Stash is a locally hosted web-based app written in Go which organizes and serves your porn.
You can watch a SFW demo video to see it in action.
For further information you can read the in-app manual.
Follow this README.md in the docker directory.
The Stash server runs on macOS, Windows, and Linux. Download the latest release here.
Run the executable (double click the exe on windows or run ./stash-osx
/ ./stash-linux
from the terminal on macOS / Linux) and navigate to either https://localhost:9999 or http://localhost:9999 to get started.
Note for Windows users: Running the app might present a security prompt since the binary isn't yet signed. Bypass this by clicking "more info" and then the "run anyway" button.
FFMPEG
If stash is unable to find or download FFMPEG then download it yourself from the link for your platform:
The ffmpeg(.exe)
and ffprobe(.exe)
files should be placed in ~/.stash
on macOS / Linux or C:\Users\YourUsername\.stash
on Windows.
Note that Stash does not currently retrieve and organize information about your entire library automatically. You will need to help it along through the use of scrapers. The Stash community has developed scrapers for many popular data sources which can be downloaded and installed from this repository.
The simplest way to tag a large number of files is by using the Tagger which uses filename keywords to help identify the file and pull in scene and performer information from our stash-box database. Note that this data source is not comprehensive and you may need to use the scrapers to identify some of your media.
Stash runs as a command-line app and local web server. There are some command-line options available, which you can see by running stash --help
.
For example, to run stash locally on port 80 run it like this (OSX / Linux) stash --host 127.0.0.1 --port 80
Stash can run over HTTPS with some additional work. First you must generate a SSL certificate and key combo. Here is an example using openssl:
openssl req -x509 -newkey rsa:4096 -sha256 -days 7300 -nodes -keyout stash.key -out stash.crt -extensions san -config <(echo "[req]"; echo distinguished_name=req; echo "[san]"; echo subjectAltName=DNS:stash.server,IP:127.0.0.1) -subj /CN=stash.server
This command would need customizing for your environment. This link might be useful.
Once you have a certificate and key file name them stash.crt
and stash.key
and place them in the ~/.stash
directory. Stash detects these and starts up using HTTPS rather than HTTP.
There is a directory of community-created themes on our Wiki, along with instructions on how to install them.
You can also make Stash interface fit your desired style with Custom CSS snippets and CSS Tweaks.
Answers to other Frequently Asked Questions can be found on our Wiki
For issues not addressed there, there are a few options.
go get github.com/mgechev/revive
go get github.com/gobuffalo/packr/v2/packr2
yarn install --frozen-lockfile
in the stash/ui/v2.5
folder (before running make generate for first time).NOTE: You may need to run the go get
commands outside the project directory to avoid modifying the projects module file.
TODO
Environment Variables
buttonGO111MODULE=on
Path
. Edit and add C:\Program Files\mingw-w64\*\mingw64\bin
(replace * with the correct path).NOTE: The make
command in Windows will be mingw32-make
with MingW.
make generate
- Generate Go and UI GraphQL filesmake build
- Builds the binary (make sure to build the UI as well... see below)make pre-ui
- Installs the UI dependencies. Only needs to be run once before building the UI for the first time, or if the dependencies are updatedmake fmt-ui
- Formats the UI source code.make ui
- Builds the frontend and the packr2 filesmake packr
- Generate packr2 files (sub-target of ui
. Use to regenerate packr2 files without rebuilding UI)make vet
- Run go vet
make lint
- Run the lintermake fmt
- Run go fmt
make fmt-check
- Ensure changed files are formatted correctlymake it
- Run the unit and integration testsmake validate
- Run all of the tests and checks required to submit a PRmake ui-start
- Runs the UI in development mode. Requires a running stash server to connect to. Stash port can be changed from the default of 9999
with environment variable REACT_APP_PLATFORM_PORT
.make generate
to create generated filesmake ui
to compile the frontendmake build
to build the executable for your current platformThis project uses a modification of the CI-GoReleaser docker container to create an environment
where the app can be cross-compiled. This process is kicked off by CI via the scripts/cross-compile.sh
script. Run the following
command to open a bash shell to the container to poke around:
docker run --rm --mount type=bind,source="$(pwd)",target=/stash -w /stash -i -t stashappdev/compiler:latest /bin/bash
Stash can be profiled using the --cpuprofile <output profile filename>
command line flag.
The resulting file can then be used with pprof as follows:
go tool pprof <path to binary> <path to profile filename>
With graphviz
installed and in the path, a call graph can be generated with:
go tool pprof -svg <path to binary> <path to profile filename> > <output svg file>
docker pull stashapp/compiler