Verify Artifactory Accessibility

Use this command to verify that Artifactory is accessible by sending an application-level ping. A successful run prints OK in the terminal.

To verify Artifactory is accessible:

1. Ensure the prerequisites are met for your scenario (URL-only ping, or a configured server ID).

2. Run a ping. When you pass a URL explicitly, use this form:

   jf rt ping --url=<ArtifactoryURL>

   Where:

   • <ArtifactoryURL> — Full Artifactory base URL (for example https://<your-subdomain>.jfrog.io/artifactory).

   Example:

   Bash

   jf rt ping --url=https://your-instance.jfrog.io/artifactory

3. Confirm the CLI prints OK. If you use a configured default server instead of --url, run jf rt ping with no arguments (or use the abbreviation jf rt p).

When to Use this Command

• Verify connectivity when configuring Artifactory for the first time
• Diagnose connection issues before running other JFrog CLI commands
• Test authentication credentials without performing actual operations
• Confirm Artifactory availability in CI/CD pipelines or monitoring scripts

Prerequisites

• JFrog CLI installed — Download and install JFrog CLI if you haven't already.
• For URL-based examples (Examples 1–7) — You need a valid Artifactory URL. No prior CLI configuration is required.
• For server-ID and default-server examples (Examples 8–10) — You must have at least one server configured via jf config add. Run jf config show to list your configured servers and their IDs.

📘

New to JFrog CLI?

Start with Example 1 below — it requires only an Artifactory URL and no prior configuration. If you need to set up a server first, see Configuring JFrog CLI.

Command Parameters

Command Options

Command Arguments

The command accepts no arguments.

Accessibility Parameter Examples

Example 1: Ping a specific server by URL

Pings the Artifactory server accessible at the specified URL. This is the most self-contained example — no prior CLI configuration required.

jf rt ping --url=https://your-instance.jfrog.io/artifactory

Expected output:

OK

Example 2: Ping with username and password authentication

Pings the Artifactory server using username and password credentials.

jf rt ping --url=https://your-instance.jfrog.io/artifactory --user=myuser --password=mypassword

Expected output:

OK

Example 3: Ping with access token authentication

Pings the Artifactory server using an access token.

jf rt ping --url=https://your-instance.jfrog.io/artifactory --access-token=your-access-token

Expected output:

OK

Example 4: Ping with SSH key authentication

Pings the Artifactory server using SSH key authentication.

jf rt ping --url=ssh://artifactory.mycompany.com:1339 --ssh-key-path=~/.ssh/id_rsa

Expected output:

OK

Example 5: Ping with SSH key and passphrase

Pings the Artifactory server using an encrypted SSH key.

jf rt ping --url=ssh://artifactory.mycompany.com:1339 --ssh-key-path=~/.ssh/id_rsa --ssh-passphrase=your-passphrase

Expected output:

OK

Example 6: Ping with client certificate (mTLS)

Pings the Artifactory server using mutual TLS authentication with client certificates.

jf rt ping --url=https://your-instance.jfrog.io/artifactory --client-cert-path=/path/to/client-cert.pem --client-cert-key-path=/path/to/client-key.pem

Expected output:

OK

Example 7: Ping with insecure TLS (skip certificate verification)

Pings the Artifactory server while skipping TLS certificate verification.

🚧

Warning

Use --insecure-tls only for testing or in trusted internal environments. It disables certificate validation entirely and should never be used in production.

jf rt ping --url=https://your-instance.jfrog.io/artifactory --insecure-tls

Expected output:

OK

Example 8: Ping default server

Pings the configured default Artifactory server.

📘

Prerequisite

A server must be configured via jf config add before running this command. Run jf config show to confirm your default server is set.

jf rt ping

Expected output:

OK

Example 9: Ping a specific server by ID

Pings a configured Artifactory server by its server ID.

📘

Note

Replace my-server-id with your actual server ID. Run jf config show to list all configured servers and their IDs.

jf rt ping --server-id=my-server-id

Expected output:

OK

Example 10: Ping using the abbreviation

Pings the default Artifactory server using the command abbreviation.

📘

Prerequisite

A server must be configured via jf config add. Run jf config show to confirm your default server is set.

jf rt p

Expected output:

OK

Troubleshooting

👍

Tip

When a command fails, the CLI prints a Trace ID in the output, for example:

[Info] Trace ID for JFrog Platform logs: 9933faa938e8b4fd

If you contact JFrog Support, include this Trace ID to help the support team locate the related server-side logs quickly.