[Tutorial] A way to run CDP on TrueNAS Scale

[WiiGe]

A way to use CDP scraper on TrueNAS Scale and install chromedp/headless-shell on TrueNAS Scale

People using stash-app on TrueNAS Scale like me may face the problem that no supported CDP app by truecharts or truenas , and now I found a way to properly run chromedp/headless-shell
.

this can be done by custom-app:

according to docker hub page of chromedp/headless-shell, we start container with docker run -d -p 9222:9222 --rm --name headless-shell --shm-size 2G chromedp/headless-shell, but this's not enough for TrueNAS Scale which run everything with K3s.

In order to run a docker image on K3s, we need to warp docker image with custom-app, fill the Container Repository with chromedp/headless-shell and Container Tag with latest so that truenas can pull the image for you.

as for the docker args docker run -d -p 9222:9222 --rm --name headless-shell --shm-size 2G chromedp/headless-shell, we need to translate the args and env parameter into custom-app configuration. Under the Workload Settings section of custom-app configuration page, there will be a list of Extra Args, we put --name headless-shell --shm-size 2G here in custom-app way:

but due to this issue, K3s will report an error of zygote: ERROR:zygote_host_impl_linux.cc(262)] Failed to adjust OOM score of renderer with pid 28: Permission denied (13), solution is simple - just offer extra args to disable it :--headless --disable-gpu --no-sandbox --no-zygote --disable-software-rasterizer --disable-dev-shm-usage

--remote-debugging-address=0.0.0.0 --remote-debugging-port=9222 is not needed because we will set port and ip on Networking and Services section for LoadBalancer (I am using 192.168.1.45 and 9222, change it for your own scenario):

the Networking section should be like this:

and, the final Extra Args page should be like this:

and click Install button then your headless-shell will be good to go

the last step: just fill stash's CDP setting with http://192.168.1.45:9222/json/version(still, change ip:port for your own scenario), and now cdp should be running for you.

An extra note is Ingress section of custom-app, you may want to use chromedp/headless-shell remotely (e.g.
accessing cdp by https://cdp.example.com/json/version), you need to modify the header of request with SetHeader function, see Host header is specified and is not an IP address or localhost. Obviously stash scraper do not support such operation, write your own scraper in this circumstances.

I just put the info I found together and share here, hope this page help more people who try to use CDP scraper on K3s-based OS.

[DogmaDragon]

Thank you. Would you be okay if I included this in documentation on https://docs.stashapp.cc?

[WiiGe]

sure！feel free to use, glad to see more stash user get helped