documentation-website icon indicating copy to clipboard operation
documentation-website copied to clipboard

[DOC] No SSL in docker-compose.yml for development

Open d96litz opened this issue 1 year ago • 2 comments

What do you want to do?

  • [x] Request a change to existing documentation
  • [ ] Add new documentation
  • [ ] Report a technical problem with the documentation
  • [ ] Other

Tell us about your request. Provide a summary of the request.

I had trouble setting up the docker-compose.yml for development because SSL was enabled. Disabling SSL solved this issue for me.

environment:
  - plugins.security.ssl.http.enabled=false

Stating this in the documentation would have saved me a lot of time. I don't think it makes sense to configure certificates for development, right?

Version: all

d96litz avatar Oct 17 '24 11:10 d96litz

@d96litz: We do have this section that calls out Docker Compose with the security plugin disabled specifically: https://opensearch.org/docs/latest/install-and-configure/install-opensearch/docker/#sample-docker-compose-file-for-development.

Naarcha-AWS avatar Oct 21 '24 23:10 Naarcha-AWS

Maybe we could link to that in a place that's more prominent in the Quickstart?

Naarcha-AWS avatar Oct 21 '24 23:10 Naarcha-AWS

I had the same exact issue, and I came across the Docker compose w/ disabled security docs page after a lot of time. To me, it would make sense to link it directly on the "Quickstart" page, even maybe making it the default way to easily try OpenSearch.

jeanprbt avatar Jun 03 '25 13:06 jeanprbt

@kolchfa-aws?

natebower avatar Jul 14 '25 19:07 natebower

@d96litz I'll add a link in the quickstart. Our current docker compose for development contains these 2 lines that disable the security plugin and demo certificates:

- "DISABLE_INSTALL_DEMO_CONFIG=true" # Prevents execution of bundled demo script which installs demo certificates and security configurations to OpenSearch
- "DISABLE_SECURITY_PLUGIN=true" # Disables Security plugin

Did you still need to add plugins.security.ssl.http.enabled=false? I don't have this on my config, and the cluster works without security.

kolchfa-aws avatar Jul 14 '25 20:07 kolchfa-aws