Skip to content

Update custom ssl docs with BASE_URL guidance #206

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 1 commit into
base: main
Choose a base branch
from

Conversation

@@ -7,7 +7,8 @@ To enable SSL with your custom certificate, follow the steps below:
1. Copy your certificate and key to certs/nginx.crt and certs/nginx.key
2. Copy your dhparam file to certs/dhparam.pem
3. Edit conf/nginx.conf to update `__server_names__` to your domain or IP address
4. Perform any other configuration edits that you might need
4. Perform any other configuration edits that you might need. Be sure to update sublime.env with the BASE_URL that will be used to access Sublime, according to your DNS configuration. See [here](https://docs.sublime.security/docs/quickstart-docker#using-a-proxy) for more details.
Copy link

@patrick-siewe-sublime patrick-siewe-sublime Apr 29, 2025

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

suggest replacing

sublime.env

With tick-brackets and a bit more context

the sublime.env file (which should be next to docker-compose.yml)

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hey Madi, we could also copy or link to the configuration reminder in the typical (non-custom) SSL instructions. See step 2 "Configure Sublime" here. It's pretty much what the customer needed to see.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@patrick-siewe-sublime I wonder if we should just remove the README in this repo? It seems confusing to have it in 2 places. I'd like to change the docs to incorporate both, ideally. We could branch, starting with step 2, into 2 sections: 1) certbot, and 2) custom certs. We could either point custom certs to here, or just copy these steps to there. This README could just include a link to the docs. Thoughts?

image

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Agreed 100% @madirey with consolidating instructions in one place is ideal.

Only question that comes to my mind is whether this is a good use of your time; if this hasn't been an issue in the two years since this Readme was touched, maybe consolidating has low ROI and it's ok to just copy the relevant details here for now (about updating sublime.env) -- unless you feel you have the time to do the larger rewrite and to get the +1 from whoever needs to give it.

Copy link
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

@patrick-siewe-sublime I'm having trouble editing the Readme docs at all, so I'm gonna place this one on hold for a bit.

@madirey madirey dismissed patrick-siewe-sublime’s stale review April 30, 2025 02:29

Dismissing review as we may need some significant changes.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

Successfully merging this pull request may close these issues.

2 participants