Skip to content

Conversation

@poissoncorp
Copy link
Contributor

Comment on lines 16 to 19
If your RavenDB instance connection is lost in the following situations:
- The certificate expired and was not renewed
- The certificate was deleted
- You were authenticating with a 2EKU server certificate, and it was renewed with 1EKU [(context)](https://ravendb.net/articles/ravendb-global-changes-in-lets-encrypt)
Copy link
Member

Choose a reason for hiding this comment

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

I think we need to explicitly mention it's about the Client Certificate


- use an existing, non-expired one
- contact your system administrator to generate one for you
- generate a new self-signed certificate (example below)
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
- generate a new self-signed certificate (example below)
- generate a new self-signed certificate yourself (example below)


You will need to connect directly to the server environment where Raven.Server process is running.

We need to send the new certificate to the production environment - so it's "reachable" for the `rvn` executable, which is located inside your RavenDB distribution package.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
We need to send the new certificate to the production environment - so it's "reachable" for the `rvn` executable, which is located inside your RavenDB distribution package.
We need make the new certificate accessible by RavenDB through the file system - so that it's "reachable" for the `rvn` executable, which is located inside your RavenDB distribution package.


We need to send the new certificate to the production environment - so it's "reachable" for the `rvn` executable, which is located inside your RavenDB distribution package.

You can use `scp`, copy via remote desktop (rdp), or any other relevant method.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
You can use `scp`, copy via remote desktop (rdp), or any other relevant method.
You can use `scp`, copy via remote desktop (RDP), or any other relevant method.

e.g.

```bash
scp certs/client.pfx user@my-server:/path/to/ravendb/RavenDB/Server/
Copy link
Member

Choose a reason for hiding this comment

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

I would not advise to put that cert in the server directory. Just home dir would do


Go to the directory where you have extracted/installed RavenDB, and run the `rvn` tool with `admin-channel` command.

The `rvn admin-channel` will connect directly to the local RavenDB server process using IPC pipe.
Copy link
Member

Choose a reason for hiding this comment

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

Suggested change
The `rvn admin-channel` will connect directly to the local RavenDB server process using IPC pipe.
The `rvn admin-channel` will connect directly to the local RavenDB server process using IPC.


The `rvn admin-channel` will connect directly to the local RavenDB server process using IPC pipe.

Once you're connected, use `trustClientCert` command.
Copy link
Contributor

Choose a reason for hiding this comment

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

Should we specify parameters for this command?

Copy link
Member

@gregolsky gregolsky left a comment

Choose a reason for hiding this comment

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

please see m,y comments

@ppekrol ppekrol merged commit 515fa5f into ravendb:main Jan 15, 2026
1 check passed
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.

4 participants