---
metadata:
  - name: generator
    content: Diplodoc Platform v5.52.0
alternate:
  - https://ydb.tech/docs/en/reference/languages-and-apis/jdbc-driver/quickstart.md?version=v25.4
  - https://ydb.tech/docs/ru/reference/languages-and-apis/jdbc-driver/quickstart.md?version=v25.4
  - href: en/reference/languages-and-apis/jdbc-driver/quickstart.md
    type: text/markdown
    title: Markdown version
  - href: ../../../llms.txt
    type: text/markdown
    title: llms.txt
sourcePath: en/core/reference/languages-and-apis/jdbc-driver/quickstart.md
---
> **Documentation Index:** Fetch the complete configuration index at https://ydb.tech/docs/en/llms.txt

# Quick start with JDBC driver

1. Download the [JDBC driver for YDB](https://github.com/ydb-platform/ydb-jdbc-driver/releases).

1. Copy the `.jar` file to the directory specified in the `CLASSPATH` environment variable or load the `.jar` file in your IDE.

1. Connect to YDB. JDBC URL examples:

    <!-- source: en/reference/languages-and-apis/jdbc-driver/_includes/jdbc-url-examples.md -->
    - Local Docker container with anonymous authentication and without TLS:<br/>`jdbc:ydb:grpc://localhost:2136/local`
    - Remote self-hosted cluster:<br/>`jdbc:ydb:grpcs://<host>:2135/Root/<testdb>?secureConnectionCertificate=file:~/<myca>.cer`
    - A cloud database instance with a token:<br/>`jdbc:ydb:grpcs://<host>:2135/<path/to/database>?token=file:~/my_token`
    - A cloud database instance with a service account:<br/>`jdbc:ydb:grpcs://<host>:2135/<path/to/database>?saFile=file:~/sa_key.json`
    <!-- endsource: en/reference/languages-and-apis/jdbc-driver/_includes/jdbc-url-examples.md -->

1. Execute queries, for example, [YdbDriverExampleTest.java](https://github.com/ydb-platform/ydb-jdbc-driver/blob/master/jdbc/src/test/java/tech/ydb/jdbc/YdbDriverExampleTest.java).