Skip to content

Commit d393cb6

Browse files
authored
Update troubleshooting.md
1 parent 297be20 commit d393cb6

File tree

1 file changed

+20
-2
lines changed

1 file changed

+20
-2
lines changed

docs/stable/extensions/troubleshooting.md

Lines changed: 20 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -6,5 +6,23 @@ redirect_from:
66
title: Troubleshooting of Extensions
77
---
88

9-
This page is a placeholder troubleshooting extension installs.
10-
For the time being, please refer to the [Installing Extensions page]({% link docs/stable/extensions/installing_extensions.md %}).
9+
You might be visiting this page directed via a DuckDB error message, similar to:
10+
```sql
11+
INSTALL non_existing;
12+
```
13+
```
14+
HTTP Error:
15+
Failed to download extension "non_existing" at URL "http://extensions.duckdb.org/v1.4.0/osx_arm64/non_existing.duckdb_extension.gz" (HTTP 404)
16+
17+
Candidate extensions: "inet", "encodings", "core_functions", "sqlite_scanner", "postgres_scanner"
18+
For more info, visit https://duckdb.org/docs/stable/extensions/troubleshooting?version=v1.4.0&platform=osx_arm64&extension=non_existing
19+
```
20+
21+
There are multiple scenarios for which an extensions might not be available in a given extension repository at a given time:
22+
* extension have not been uploaded yet, here some delay after a given release date might be expected. Consider checking the issues at duckdb/duckdb or duckdb/community-extensions, or creating one yourself.
23+
* extension is available, but in a different repository, try for example `INSTALL <name> FROM core;` or `INSTALL <name> FROM community;` or `INSTALL <name> FROM core_nightly;` (check https://duckdb.org/docs/stable/extensions/installing_extensions#extension-repositories)
24+
* networking issues, so extension exists at the endpoint but it's not reachable from your local DuckDB. Here you can try visiting the given URL via a browser directly pasting the link from the error message in the search bar.
25+
26+
If you are on a development version of DuckDB, that is any version for which `PRAGMA version` returns a library_version not starting with a `v`, then extensions might not be available anymore on the default extension repository.
27+
28+
Consider raising an issue on duckdb/duckdb if in doubt.

0 commit comments

Comments
 (0)