Docker enviroment for testing and deployment

[Marzal]

Hi, I'm being trying without luck to install a local dev environment with docker.

I've tried al these images (from [1]):

• node:25-trixie-slim (no git)
• node:25-trixie (no corepack since 25)
• node:24-trixie (yarn install Failed with errors)
• node:22-trixie (yarn install Failed with errors)
• node:20-trixie (yarn install Done with warnings - Error in yarn dev needs workaournd)
  • Needs export NODE_OPTIONS=--openssl-legacy-provider

So my first question is:

• What nodejs version is the web right now running / What should be I targeting?
  Anything <20 it's EOL

Related to #511 (comment)

node:20-trixie

yarn install

➤ YN0000: ┌ Resolution step
➤ YN0002: │ @mdx-js/loader@npm:1.6.18 doesn't provide react (pccc61), requested by @mdx-js/react
➤ YN0002: │ @storybook/addon-essentials@npm:6.0.26 [53d9f] doesn't provide @babel/core (p7935e), requested by @storybook/addon-docs
➤ YN0002: │ @storybook/core@npm:6.0.26 [719ac] doesn't provide typescript (pe9342), requested by fork-ts-checker-webpack-plugin
➤ YN0002: │ @storybook/core@npm:6.0.26 [fa6e2] doesn't provide typescript (pbc76b), requested by fork-ts-checker-webpack-plugin
➤ YN0002: │ @storybook/preset-create-react-app@npm:3.1.4 [53d9f] doesn't provide typescript (p0e128), requested by react-docgen-typescript-plugin
➤ YN0002: │ @storybook/react@npm:6.0.26 [53d9f] doesn't provide typescript (p503a5), requested by react-docgen-typescript-plugin
➤ YN0002: │ @types/redux-thunk@npm:2.1.0 doesn't provide redux (p992af), requested by redux-thunk
➤ YN0002: │ podcastindex@workspace:. doesn't provide immutable (pe6d0c), requested by connected-react-router
➤ YN0002: │ podcastindex@workspace:. doesn't provide prop-types (p3d074), requested by react-loading
➤ YN0002: │ podcastindex@workspace:. doesn't provide react-router (pefc5d), requested by connected-react-router
➤ YN0002: │ podcastindex@workspace:. doesn't provide seamless-immutable (p410e7), requested by connected-react-router
➤ YN0002: │ react-docgen-typescript-loader@npm:3.7.2 [9f7c3] doesn't provide webpack (p6f623), requested by @webpack-contrib/schema-utils
➤ YN0000: │ Some peer dependencies are incorrectly met; run yarn explain peer-requirements for details, where is the six-letter p-prefixed code
➤ YN0000: └ Completed in 0s 338ms
➤ YN0000: ┌ Fetch step
➤ YN0013: │ yargs-parser@npm:10.1.0 can't be found in the cache and will be fetched from the remote registry
➤ YN0013: │ yargs-parser@npm:13.1.2 can't be found in the cache and will be fetched from the remote registry
➤ YN0013: │ yargs@npm:12.0.2 can't be found in the cache and will be fetched from the remote registry
➤ YN0013: │ zwitch@npm:1.0.5 can't be found in the cache and will be fetched from the remote registry
➤ YN0013: │ yargs@npm:13.3.2 can't be found in the cache and will be fetched from the remote registry
➤ YN0000: └ Completed in 2s 741ms
➤ YN0000: ┌ Link step
➤ YN0007: │ core-js@npm:3.6.5 must be built because it never has been before or the last one failed
➤ YN0007: │ sharp@npm:0.25.4 must be built because it never has been before or the last one failed
➤ YN0007: │ core-js-pure@npm:3.6.5 must be built because it never has been before or the last one failed
➤ YN0007: │ core-js@npm:2.6.11 must be built because it never has been before or the last one failed
➤ YN0000: └ Completed in 15s 752ms
➤ YN0000: Done with warnings in 19s 118ms

Fix yarn dev

export NODE_OPTIONS=--openssl-legacy-provider
yarn dev

yarn dev

ℹ ｢wds｣: Project is running at http://localhost:9001/
ℹ ｢wds｣: webpack output is served from /
ℹ ｢wds｣: Content not from webpack is served from /srv/web-ui/server/www
ℹ ｢wds｣: 404s will fallback to /index.html
node:internal/crypto/hash:101
  this[kHandle] = new _Hash(algorithm, xofLen, algorithmId, getHashCache());
                  ^

Error: error:0308010C:digital envelope routines::unsupported
    at new Hash (node:internal/crypto/hash:101:19)
    at Object.createHash (node:crypto:139:10)
    at module.exports (/srv/web-ui/node_modules/webpack/lib/util/createHash.js:135:53)
    at NormalModule._initBuildHash (/srv/web-ui/node_modules/webpack/lib/NormalModule.js:417:16)
    at handleParseError (/srv/web-ui/node_modules/webpack/lib/NormalModule.js:471:10)
    at /srv/web-ui/node_modules/webpack/lib/NormalModule.js:503:5
    at /srv/web-ui/node_modules/webpack/lib/NormalModule.js:358:12
    at /srv/web-ui/node_modules/loader-runner/lib/LoaderRunner.js:373:3
    at iterateNormalLoaders (/srv/web-ui/node_modules/loader-runner/lib/LoaderRunner.js:214:10)
    at Array.<anonymous> (/srv/web-ui/node_modules/loader-runner/lib/LoaderRunner.js:205:4) {
  opensslErrorStack: [
    'error:03000086:digital envelope routines::initialization error',
    'error:0308010C:digital envelope routines::unsupported'
  ],
  library: 'digital envelope routines',
  reason: 'unsupported',
  code: 'ERR_OSSL_EVP_UNSUPPORTED'
}

node:22-trixie (Failed with errors)

➤ YN0065: Yarn will periodically gather anonymous telemetry: https://yarnpkg.com/advanced/telemetry
➤ YN0065: Run yarn config set --home enableTelemetry 0 to disable

➤ YN0000: ┌ Resolution step
➤ YN0002: │ @mdx-js/loader@npm:1.6.18 doesn't provide react (pccc61), requested by @mdx-js/react
➤ YN0002: │ @storybook/addon-essentials@npm:6.0.26 [53d9f] doesn't provide @babel/core (p7935e), requested by @storybook/addon-docs
➤ YN0002: │ @storybook/core@npm:6.0.26 [719ac] doesn't provide typescript (pe9342), requested by fork-ts-checker-webpack-plugin
➤ YN0002: │ @storybook/core@npm:6.0.26 [fa6e2] doesn't provide typescript (pbc76b), requested by fork-ts-checker-webpack-plugin
➤ YN0002: │ @storybook/preset-create-react-app@npm:3.1.4 [53d9f] doesn't provide typescript (p0e128), requested by react-docgen-typescript-plugin
➤ YN0002: │ @storybook/react@npm:6.0.26 [53d9f] doesn't provide typescript (p503a5), requested by react-docgen-typescript-plugin
➤ YN0002: │ @types/redux-thunk@npm:2.1.0 doesn't provide redux (p992af), requested by redux-thunk
➤ YN0002: │ podcastindex@workspace:. doesn't provide immutable (pe6d0c), requested by connected-react-router
➤ YN0002: │ podcastindex@workspace:. doesn't provide prop-types (p3d074), requested by react-loading
➤ YN0002: │ podcastindex@workspace:. doesn't provide react-router (pefc5d), requested by connected-react-router
➤ YN0002: │ podcastindex@workspace:. doesn't provide seamless-immutable (p410e7), requested by connected-react-router
➤ YN0002: │ react-docgen-typescript-loader@npm:3.7.2 [9f7c3] doesn't provide webpack (p6f623), requested by @webpack-contrib/schema-utils
➤ YN0000: │ Some peer dependencies are incorrectly met; run yarn explain peer-requirements <hash> for details, where <hash> is the six-letter p-prefixed code
➤ YN0000: └ Completed in 0s 339ms
➤ YN0000: ┌ Fetch step
➤ YN0013: │ yargs-parser@npm:10.1.0 can't be found in the cache and will be fetched from the remote registry
➤ YN0013: │ yargs-parser@npm:13.1.2 can't be found in the cache and will be fetched from the remote registry
➤ YN0013: │ yargs@npm:12.0.2 can't be found in the cache and will be fetched from the remote registry
➤ YN0013: │ yargs@npm:13.3.2 can't be found in the cache and will be fetched from the remote registry
➤ YN0013: │ zwitch@npm:1.0.5 can't be found in the cache and will be fetched from the remote registry
➤ YN0000: └ Completed in 38s 167ms
➤ YN0000: ┌ Link step
➤ YN0007: │ core-js@npm:3.6.5 must be built because it never has been before or the last one failed
➤ YN0007: │ sharp@npm:0.25.4 must be built because it never has been before or the last one failed
➤ YN0007: │ core-js-pure@npm:3.6.5 must be built because it never has been before or the last one failed
➤ YN0007: │ core-js@npm:2.6.11 must be built because it never has been before or the last one failed
➤ YN0009: │ sharp@npm:0.25.4 couldn't be built successfully (exit code 1, logs can be found here: /tmp/xfs-951f88d5/build.log)
➤ YN0000: └ Completed in 18s 530ms
➤ YN0000: Failed with errors in 57s 345ms

Instruction to update the readme when working

git clone https://github.com/Podcastindex-org/web-ui.git
cd web-ui
cp .env-example .env
cp .env-example .environments/.env.development

#yarn exec env
corepack -v && export COREPACK_ENABLE_DOWNLOAD_PROMPT=0
corepack enable

yarn install
export NODE_OPTIONS=--openssl-legacy-provider
yarn dev
yarn start

[stevencrader]

• What nodejs version is the web right now running / What should be I targeting?
  Anything <20 it's EOL

We are currently using v16.20.2

Even though it is EOL, it may be worth getting the container running the same version first and then worry about upgrading. I'm sure the upgrade is not going to be easy with packages changing or being abandoned.

[Marzal]

We are currently using v16.20.2

Thanks, first time working with node.
Are you using nvm use?

Even though it is EOL, it may be worth getting the container running the same version first and then worry about upgrading. I'm sure the upgrade is not going to be easy with packages changing or being abandoned.

Agree, will try to get that version running.

With node 20 I got to have it kinda working with yarn production, npm run build had some errors.
And I didn't get to figure out yarn dev (port 9001 open but not working), will try with 16.20.2 (node:gallium-bookworm)

[Marzal]

No luck with node:20-trixie using nvm to get node v16.20.2

Also no luck with docker image node:gallium-bookworm

# node -v
v16.20.2
# corepack -v 
0.17.0
# yarn -v
3.4.1
# npm -v
8.19.4
# grep PRETTY /etc/os-release 
PRETTY_NAME="Debian GNU/Linux 12 (bookworm)"

What stack are you (or the production server) using?

npm run build

> podcastindex@0.2.1 build
> webpack

/srv/web-ui/node_modules/webpack-cli/bin/cli.js:93
                                throw err;
                                ^

TypeError: Cannot read properties of undefined (reading 'file')
    at module.exports (/srv/web-ui/webpack.config.js:143:46)
    at handleFunction (/srv/web-ui/node_modules/webpack-cli/bin/utils/prepareOptions.js:21:13)
    at prepareOptions (/srv/web-ui/node_modules/webpack-cli/bin/utils/prepareOptions.js:9:5)
    at requireConfig (/srv/web-ui/node_modules/webpack-cli/bin/utils/convert-argv.js:117:14)
    at /srv/web-ui/node_modules/webpack-cli/bin/utils/convert-argv.js:123:17
    at Array.forEach (<anonymous>)
    at module.exports (/srv/web-ui/node_modules/webpack-cli/bin/utils/convert-argv.js:121:15)
    at /srv/web-ui/node_modules/webpack-cli/bin/cli.js:71:45
    at Object.parse (/srv/web-ui/node_modules/yargs/yargs.js:576:18)
    at /srv/web-ui/node_modules/webpack-cli/bin/cli.js:49:8
    at Object.<anonymous> (/srv/web-ui/node_modules/webpack-cli/bin/cli.js:366:3)
    at Module._compile (node:internal/modules/cjs/loader:1198:14)
    at Object.Module._extensions..js (node:internal/modules/cjs/loader:1252:10)
    at Module.load (node:internal/modules/cjs/loader:1076:32)
    at Function.Module._load (node:internal/modules/cjs/loader:911:12)
    at Module.require (node:internal/modules/cjs/loader:1100:19)
    at require (node:internal/modules/cjs/helpers:119:18)
    at Object.<anonymous> (/srv/web-ui/node_modules/webpack/bin/webpack.js:156:2)
    at Module._compile (node:internal/modules/cjs/loader:1198:14)
    at Object.Module._extensions..js (node:internal/modules/cjs/loader:1252:10)
    at Module.load (node:internal/modules/cjs/loader:1076:32)
    at Function.Module._load (node:internal/modules/cjs/loader:911:12)
    at Function.executeUserEntryPoint [as runMain] (node:internal/modules/run_main:81:12)
    at node:internal/main/run_main_module:22:47

[ericpp]

I use NVM for developing https://github.com/nvm-sh/nvm

Basically,

nvm install 16
nvm use 16
corepack enable
yarn install
yarn run dev &
yarn run start

[Marzal]

According to this commit 94c8dc2

I should have:

-rw-r--r-- 1 root root 470 Feb  6 20:28 .environments/.env.development
-rw-r--r-- 1 root root 472 Feb  6 20:07 .environments/.env.production
-rw-r--r-- 1 root root   7 Feb  6 16:57 .environments/.gitignore

yarn run dev works and launchs
/usr/local/bin/node /srv/web-ui/node_modules/webpack-dev-server/bin/webpack-dev-server.js --env.file=development --mode development --devtool inline-source-map with the output:

ℹ ｢wds｣: Project is running at http://localhost:9001/
ℹ ｢wds｣: webpack output is served from /
ℹ ｢wds｣: Content not from webpack is served from /srv/web-ui/server/www
ℹ ｢wds｣: 404s will fallback to /index.html
ℹ ｢wdm｣: Hash: 35603d0be1b9dc1292ca
Version: webpack 4.44.2
Time: 8905ms
Built at: 02/06/2026 8:50:07 PM
                                    Asset       Size  Chunks             Chunk Names
                       ../views/index.ejs   12.6 KiB          [emitted]  
             ./android-chrome-144x144.png   9.94 KiB          [emitted]  
             ./android-chrome-192x192.png   13.9 KiB          [emitted]  
....
    Entrypoint pci_avatar.svg = c9f67a94475e7e4462fb
    [./node_modules/cache-loader/dist/cjs.js?{"cacheDirectory":"/srv/web-ui/node_modules/.cache/favicons-webpack-plugin"}!./node_modules/favicons-webpack-plugin/src/loader.js?{"prefix":".","options":{"appName":"Podcastindex.org","appDescription":"Let’s preserve podcasting as a platform for free speech","developerName":"Podcastindex.org","developerURL":null,"background":"#ffffff","theme_color":"#e90000","icons":{"coast":false,"yandex":false},"version":"0.2.1"},"path":"/"}!./ui/public/pci_avatar.svg] 4.45 MiB {pci_avatar.svg} [built]
ℹ ｢wdm｣: Compiled successfully.

But yarn run start fails with:

/srv/web-ui/node_modules/podcast-index-api/index.js:61
        throw new Error(
        ^
Error: API Key and Secret are required from https://api.podcastindex.org/

If I cp .environments/.env.development .env I do get server started on port 5001
So as far as I understand:

yarn run dev uses .environments/.env.development
yarn run production uses .environments/.env.production
yarn/npm start uses .env instead of the .environments/* ones

But yarn/npm build keeps failing with this 3 files configured:

> podcastindex@0.2.1 build
> webpack

/srv/web-ui/node_modules/webpack-cli/bin/cli.js:93
                                throw err;
                                ^
TypeError: Cannot read properties of undefined (reading 'file')
    at module.exports (/srv/web-ui/webpack.config.js:143:46)

Not finding the file variable.
yarn run production works because it calls
NODE_ENV='production' && webpack --env.file=production --mode production && node server

I'm missing something or there is some kind of inconsistency:

• Does build and start need to be changed on the scripts?

  web-ui/package.json

  Lines 83 to 85 in 68a69e4

  	"build": "webpack",
  	"production": "NODE_ENV='production' && webpack --env.file=production --mode production && node server",
  	"start": "node server",

• I'm missing some variables?
• Do we really need the .env file on the root and on the .environments/.env.development duplicated?

PD: First time playing with node, but I try to understand how it works.

I could skip the build part and use yarn start with the duplicate .env file, but I'm also trying to document how to create a docker image of this project for production and for that I'm not sure if the npm run build && npm start described on the documentation are really needed.

[ericpp]

I have both of those symlinked to .env:

cd .environments/
ln -s ../.env .env.development
ln -s ../.env .env.production

[Marzal]

I have both of those symlinked to .env:

Thanks, at least I know that [right now] all those 3 files are necessary 😅

Does yarn/npm build works for you?

[ericpp]

I only use yarn run dev and yarn run server for developing stuff.

It looks like the build command is missing --env.file in package.json . I'm not sure how @daveajones runs this in production.

[ericpp]

It looks like you can run this on newer Node versions by adding NODE_OPTIONS=--openssl-legacy-provider to the webpack commands in package.json:

        "dev": "NODE_OPTIONS=--openssl-legacy-provider webpack-dev-server --env.file=development --mode development --devtool inline-source-map",
        "build": "NODE_OPTIONS=--openssl-legacy-provider webpack",
        "production": "NODE_OPTIONS=--openssl-legacy-provider NODE_ENV='production' && webpack --env.file=production --mode production && node server",

[Marzal]

It looks like you can run this on newer Node versions by adding NODE_OPTIONS=--openssl-legacy-provider to the webpack commands in package.json:

Yes with NODE_OPTIONS=--openssl-legacy-provider I got the dev commands to work on node:20-trixie but I had the other problems (.env / build ...) so I went to 16 to start testing with something that should work.
Also you can't use this when running node 16 or it will fail with : --openssl-legacy-provider is not allowed in NODE_OPTIONS

By the way, I got build to work using:
"build": "NODE_ENV='production' && webpack --env.file=production --mode production"
or just:
"build": "webpack --env.file=production"

Assuming that the build command it's for production as per the docu on the README.

Thanks

[Marzal]

OK so I think it's not possible right now to run npm/yarn start without having a third .env on the root folder of the project.

DotEnv plugins defaults to ./env, and start just uses node without accepting webpack parameters like --env.file.
I've seen people using webpack serve instead, but I think it's too much trouble. I will update de README to reflect that you need all 3 files.

This seems like the same problem that #231

On the good side, I've been doing all the testing on Node 20 without problems, and also found why I could use localhost:9001 after yarn dev -> #524