diff --git a/website/docs/docs/dbt-cloud-apis/user-tokens.md b/website/docs/docs/dbt-cloud-apis/user-tokens.md
index b7bf4fdce28..bde58793481 100644
--- a/website/docs/docs/dbt-cloud-apis/user-tokens.md
+++ b/website/docs/docs/dbt-cloud-apis/user-tokens.md
@@ -6,7 +6,7 @@ pagination_next: "docs/dbt-cloud-apis/service-tokens"
# Account-scoped personal access tokens
-:::Warning
+:::warning
User API tokens have been deprecated and will no longer work. [Migrate](#migrate-deprecated-user-api-keys-to-personal-access-tokens) to personal access tokens to resume services.
diff --git a/website/docs/docs/get-started-dbt.md b/website/docs/docs/get-started-dbt.md
index 1920a9b3da2..e1a873a5f97 100644
--- a/website/docs/docs/get-started-dbt.md
+++ b/website/docs/docs/get-started-dbt.md
@@ -85,10 +85,10 @@ Learn more about [dbt Cloud features](/docs/cloud/about-cloud/dbt-cloud-feature
icon="dbt-bit"/>
+ title="Quickstart for dbt Core using DuckDB"
+ body="Learn how to connect to DuckDB."
+ link="https://docs.getdbt.com/guides/duckdb?step=1"
+ icon="duckdb"/>
## Related docs
diff --git a/website/docs/guides/codespace-qs.md b/website/docs/guides/codespace-qs.md
deleted file mode 100644
index 5f874661313..00000000000
--- a/website/docs/guides/codespace-qs.md
+++ /dev/null
@@ -1,77 +0,0 @@
----
-title: Quickstart for dbt Core using GitHub Codespaces
-id: codespace
-platform: 'dbt-core'
-icon: 'fa-github'
-level: 'Beginner'
-hide_table_of_contents: true
-tags: ['dbt Core','Quickstart']
----
-
-
-
-## Introduction
-
-In this quickstart guide, you’ll learn how to create a codespace and be able to execute the `dbt build` command from it in _less than 5 minutes_.
-
-dbt Labs provides a [GitHub Codespace](https://docs.github.com/en/codespaces/overview) template that you (and anyone else) can reuse to create a complete dbt environment with a working and runnable project. When you create the codespace, the [dev container](https://docs.github.com/en/codespaces/setting-up-your-project-for-codespaces/adding-a-dev-container-configuration/introduction-to-dev-containers) creates a fully functioning dbt environment, connects to a DuckDB database, and loads a year of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities. The [README](https://github.com/dbt-labs/jaffle-shop-template#readme) for the Jaffle Shop template also provides instructions on how to do this, along with animated GIFs.
-
-### Prerequisites
-
-- To use the dbt command-line interface (CLI), it's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily.
-- You have a [GitHub account](https://github.com/join).
-
-## Related content
-
-- [Create a GitHub repository](/guides/manual-install?step=2)
-- [Build your first models](/guides/manual-install?step=3)
-- [Test and document your project](/guides/manual-install?step=4)
-- [Schedule a job](/guides/manual-install?step=5)
-- Learn more with [dbt Learn courses](https://learn.getdbt.com)
-
-## Create a codespace
-
-1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle-shop-template) after you log in to your GitHub account.
-1. Click **Use this template** at the top of the page and choose **Create new repository**.
-1. Click **Create repository from template** when you’re done setting the options for your new repository.
-1. Click **Code** (at the top of the new repository’s page). Under the **Codespaces** tab, choose **Create codespace on main**. Depending on how you've configured your computer's settings, this either opens a new browser tab with the Codespace development environment with VSCode running in it or opens a new VSCode window with the codespace in it.
-1. Wait for the codespace to finish building by waiting for the `postCreateCommand` command to complete; this can take several minutes:
-
-
-
- When this command completes, you can start using the codespace development environment. The terminal the command ran in will close and you will get a prompt in a brand new terminal.
-
-1. At the terminal's prompt, you can execute any dbt command you want. For example:
-
- ```shell
- /workspaces/test (main) $ dbt build
- ```
-
- You can also use the [duckcli](https://github.com/dbcli/duckcli) to write SQL against the warehouse from the command line or build reports in the [Evidence](https://evidence.dev/) project provided in the `reports` directory.
-
- For complete information, refer to the [dbt command reference](https://docs.getdbt.com/reference/dbt-commands). Common commands are:
-
- - [dbt compile](https://docs.getdbt.com/reference/commands/compile) — generates executable SQL from your project source files
- - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project
- - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project
- - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project
-
-## Generate a larger data set
-
-If you'd like to work with a larger selection of Jaffle Shop data, you can generate an arbitrary number of years of fictitious data from within your codespace.
-
-1. Install the Python package called [jafgen](https://pypi.org/project/jafgen/). At the terminal's prompt, run:
-
- ```shell
- /workspaces/test (main) $ python -m pip install jafgen
- ```
-
-1. When installation is done, run:
- ```shell
- /workspaces/test (main) $ jafgen --years NUMBER_OF_YEARS
- ```
- Replace `NUMBER_OF_YEARS` with the number of years you want to simulate. This command builds the CSV files and stores them in the `jaffle-data` folder, and is automatically sourced based on the `sources.yml` file and the [dbt-duckdb](/docs/core/connect-data-platform/duckdb-setup) adapter.
-
-As you increase the number of years, it takes exponentially more time to generate the data because the Jaffle Shop stores grow in size and number. For a good balance of data size and time to build, dbt Labs suggests a maximum of 6 years.
-
-
\ No newline at end of file
diff --git a/website/docs/guides/duckdb-qs.md b/website/docs/guides/duckdb-qs.md
new file mode 100644
index 00000000000..38d02b48381
--- /dev/null
+++ b/website/docs/guides/duckdb-qs.md
@@ -0,0 +1,309 @@
+---
+title: Quickstart for dbt Core using DuckDB
+id: duckdb
+description: "Learn to use dbt Core using DuckDB."
+hoverSnippet: "Learn to use dbt Core using DuckDB."
+platform: 'dbt-core'
+icon: 'duckdb-seeklogo'
+level: 'Beginner'
+hide_table_of_contents: true
+tags: ['dbt Core','Quickstart']
+---
+
+
+
+## Introduction
+
+In this quickstart guide, you'll learn how to use dbt Core with DuckDB, enabling you to get set up quickly and efficiently. [DuckDB](https://duckdb.org/) is an open-source database management system which is designed for analytical workloads. It is designed to provide fast and easy access to large datasets, making it well-suited for data analytics tasks.
+
+
+This guide will demonstrate how to:
+
+- [Create a virtual development environment](/docs/core/pip-install#using-virtual-environments) using a template provided by dbt Labs.
+ - This sets up a fully functional dbt environment with an operational and executable project. The codespace automatically connects to the DuckDB database and loads a year's worth of data from our fictional Jaffle Shop café, which sells food and beverages in several US cities.
+ - For additional information, refer to the [README](https://github.com/dbt-labs/jaffle_shop_duckdb/blob/duckdb/README.md) for the Jaffle Shop template. It includes instructions on how to do this, along with animated GIFs.
+- Run any dbt command from the environment’s terminal.
+- Generate a larger dataset for the Jaffle Shop café (for example, five years of data instead of just one).
+
+You can learn more through high-quality [dbt Learn courses and workshops](https://learn.getdbt.com).
+
+
+### Related content
+
+
+- [DuckDB setup](/docs/core/connect-data-platform/duckdb-setup)
+- [Create a GitHub repository](/guides/manual-install?step=2)
+- [Build your first models](/guides/manual-install?step=3)
+- [Test and document your project](/guides/manual-install?step=4)
+
+
+## Prerequisites
+
+- When using DuckDB with dbt Core, you'll need to use the dbt command-line interface (CLI). Currently, DuckDB is not supported in dbt Cloud.
+- It's important that you know some basics of the terminal. In particular, you should understand `cd`, `ls` , and `pwd` to navigate through the directory structure of your computer easily.
+- You have a [GitHub account](https://github.com/join).
+
+## Set up DuckDB for dbt Core
+
+This section will provide a step-by-step guide for setting up DuckDB for use in local (Mac and Windows) environments and web browsers.
+
+In the repository, there's a [`requirements.txt`](https://github.com/dbt-labs/jaffle_shop_duckdb/blob/duckdb/requirements.txt) file which is used to install dbt Core, DuckDB, and all other necessary dependencies. You can check this file to see what will be installed on your machine. It's typically located in the root directory of your project.
+
+The `requirements.txt` file is placed at the top level of your dbt project directory, alongside other key files like `dbt_project.yml`:
+
+
+```shell
+
+/my_dbt_project/
+├── dbt_project.yml
+├── models/
+│ ├── my_model.sql
+├── tests/
+│ ├── my_test.sql
+└── requirements.txt
+
+```
+
+For more information, refer to the [DuckDB setup](/docs/core/connect-data-platform/duckdb-setup).
+
+
+
+
+
+1. First, [clone](https://git-scm.com/docs/git-clone) the Jaffle Shop git repository by running the following command in your terminal:
+
+
+
+ ```bash
+ git clone https://github.com/dbt-labs/jaffle_shop_duckdb.git
+
+ ```
+
+2. Change into the docs-duckdb directory from the command line:
+
+ ```shell
+
+ cd jaffle_shop_duck_db
+
+ ```
+
+
+3. Install dbt Core and DuckDB in a virtual environment.
+
+
+
+ ```shell
+
+ python3 -m venv venv
+ source venv/bin/activate
+ python3 -m pip install --upgrade pip
+ python3 -m pip install -r requirements.txt
+ source venv/bin/activate
+
+ ```
+
+
+
+
+ ```shell
+
+ python -m venv venv
+ venv\Scripts\activate.bat
+ python -m pip install --upgrade pip
+ python -m pip install -r requirements.txt
+ venv\Scripts\activate.bat
+
+ ```
+
+
+
+
+
+ ```shell
+
+ python -m venv venv
+ venv\Scripts\Activate.ps1
+ python -m pip install --upgrade pip
+ python -m pip install -r requirements.txt
+ venv\Scripts\Activate.ps1
+
+ ```
+
+
+
+4. Ensure your profile is setup correctly from the command line by running the following [dbt commands](/reference/dbt-commands).
+
+
+ - [dbt compile](/reference/commands/compile) — generates executable SQL from your project source files
+ - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project
+ - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project
+ - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project
+ - [dbt docs generate](/reference/commands/cmd-docs#dbt-docs-generate) — generates your project's documentation.
+ - [dbt docs serve](/reference/commands/cmd-docs#dbt-docs-serve) — starts a webserver on port 8080 to serve your documentation locally and opens the documentation site in your default browser.
+
+For complete details, refer to the [dbt command reference](/reference/dbt-commands).
+
+Here's what a successful output will look like:
+
+```jinja
+
+(venv) ➜ jaffle_shop_duckdb git:(duckdb) dbt build
+15:10:12 Running with dbt=1.8.1
+15:10:13 Registered adapter: duckdb=1.8.1
+15:10:13 Found 5 models, 3 seeds, 20 data tests, 416 macros
+15:10:13
+15:10:14 Concurrency: 24 threads (target='dev')
+15:10:14
+15:10:14 1 of 28 START seed file main.raw_customers ..................................... [RUN]
+15:10:14 2 of 28 START seed file main.raw_orders ........................................ [RUN]
+15:10:14 3 of 28 START seed file main.raw_payments ...................................... [RUN]
+....
+
+15:10:15 27 of 28 PASS relationships_orders_customer_id__customer_id__ref_customers_ .... [PASS in 0.32s]
+15:10:15
+15:10:15 Finished running 3 seeds, 3 view models, 20 data tests, 2 table models in 0 hours 0 minutes and 1.52 seconds (1.52s).
+15:10:15
+15:10:15 Completed successfully
+15:10:15
+15:10:15 Done. PASS=28 WARN=0 ERROR=0 SKIP=0 TOTAL=28
+
+```
+To query data, some useful commands you can run from the command line:
+
+- [`dbt show`](/reference/commands/show) — run a query against the data warehouse and preview the results in the terminal.
+- [`dbt source`](/reference/commands/source) — provides subcommands such as [`dbt source freshness`](/reference/commands/source#dbt-source-freshness) that are useful when working with source data.
+ - `dbt source freshness` — checks the freshness (how up to date) a specific source table is.
+
+:::note
+
+The steps will fail if you decide to run this project in your data warehouse (outside of this DuckDB demo). You will need to reconfigure the project files for your warehouse. Definitely consider this if you are using a community-contributed adapter.
+
+:::
+
+
+### Troubleshoot
+
+
+
+ ```Jinja
+
+ IO Error: Could not set lock on file "jaffle_shop.duckdb": Resource temporarily unavailable
+
+ ```
+
+ This is a known issue in DuckDB. Try disconnecting from any sessions that are locking the database. If you are using DBeaver, this means shutting down DBeaver (disconnecting doesn't always work).
+
+ As a last resort, deleting the database file will get you back in action (_but_ you will lose all your data).
+
+
+
+
+
+
+
+
+1. Go to the `jaffle-shop-template` [repository](https://github.com/dbt-labs/jaffle_shop_duckdb) after you log in to your GitHub account.
+1. Click **Use this template** at the top of the page and choose **Create new repository**.
+1. Click **Create repository from template** when you’re done setting the options for your new repository.
+1. Click **Code** (at the top of the new repository’s page). Under the **Codespaces** tab, choose **Create codespace on main**. Depending on how you've configured your computer's settings, this either opens a new browser tab with the Codespace development environment with VSCode running in it or opens a new VSCode window with the codespace in it.
+1. Wait for the codespace to finish building by waiting for the `postCreateCommand` command to complete; this can take several minutes:
+
+
+
+ When this command completes, you can start using the codespace development environment. The terminal the command ran in will close and you will get a prompt in a brand new terminal.
+
+1. At the terminal's prompt, you can execute any dbt command you want. For example:
+
+ ```shell
+ /workspaces/test (main) $ dbt build
+ ```
+
+ You can also use the [duckcli](https://duckdb.org/docs/api/cli/overview.html) to write SQL against the warehouse from the command line or build reports in the [Evidence](https://evidence.dev/) project provided in the `reports` directory.
+
+ For complete information, refer to the [dbt command reference](https://docs.getdbt.com/reference/dbt-commands). Common commands are:
+
+ - [dbt compile](/reference/commands/compile) — generates executable SQL from your project source files
+ - [dbt run](https://docs.getdbt.com/reference/commands/run) — compiles and runs your project
+ - [dbt test](https://docs.getdbt.com/reference/commands/test) — compiles and tests your project
+ - [dbt build](https://docs.getdbt.com/reference/commands/build) — compiles, runs, and tests your project
+
+
+
+
+
+
+
+
+
+
+
+
+## Generate a larger data set
+
+If you'd like to work with a larger selection of Jaffle Shop data, you can generate an arbitrary number of years of fictitious data from within your codespace.
+
+1. Install the Python package called [jafgen](https://pypi.org/project/jafgen/). At the terminal's prompt, run:
+
+ ```shell
+ python -m pip install jafgen
+ ```
+
+1. When installation is done, run:
+ ```shell
+ jafgen [number of years to generate] # e.g. jafgen 6
+ ```
+ Replace `NUMBER_OF_YEARS` with the number of years you want to simulate. This command builds the CSV files and stores them in the `jaffle-data` folder, and is automatically sourced based on the `sources.yml` file and the [dbt-duckdb](/docs/core/connect-data-platform/duckdb-setup) adapter.
+
+As you increase the number of years, it takes exponentially more time to generate the data because the Jaffle Shop stores grow in size and number. For a good balance of data size and time to build, dbt Labs suggests a maximum of 6 years.
+## Next steps
+
+Now that you have dbt Core, DuckDB, and the Jaffle Shop data up and running, you can explore dbt's capabilities. Refer to these materials to get a better understanding of dbt projects and commands:
+
+- The [About projects](/docs/build/projects) page guides you through the structure of a dbt project and its components.
+- [dbt command reference](/reference/dbt-commands) explains the various commands available and what they do.
+- [dbt Labs courses](https://courses.getdbt.com/collections) offer a variety of beginner, intermediate, and advanced learning modules designed to help you become a dbt expert.
+- Once you see the potential of dbt and what it can do for your organization, sign up for a free trial of [dbt Cloud](https://www.getdbt.com/signup). It's the fastest and easiest way to deploy dbt today!
+- Check out the other [quickstart guides](/guides?tags=Quickstart) to begin integrating into your existing data warehouse.
+
+Additionally, with your new understanding of the basics of using DuckDB, consider optimizing your setup by [documenting your project](/guides/duckdb#document-your-project), [commit your changes](/guides/duckdb#commit-your-changes) and, [schedule a job](/guides/duckdb#schedule-a-job).
+
+### Document your project
+
+To document your dbt projects with DuckDB, follow the steps:
+
+- Use the `dbt docs generate` command to compile information about your dbt project and warehouse into `manifest.json` and `catalog.json` files
+- Run the [`dbt docs serve`](/reference/commands/cmd-docs#dbt-docs-serve) command to create a local website using the generated `.json` files. This allows you to view your project's documentation in a web browser.
+- Enhance your documentation by adding [descriptions](/reference/resource-properties/description) to models, columns, and sources using the `description` key in your YAML files.
+
+### Commit your changes
+
+Commit your changes to ensure the repository is up to date with the latest code.
+
+1. In the GitHub repository you created for your project, run the following commands in the terminal:
+
+```shell
+git add
+git commit -m "Your commit message"
+git push
+```
+
+2. Go back to your GitHub repository to verify your new files have been added.
+
+### Schedule a job
+
+1. Ensure dbt Core is installed and configured to connect to your DuckDB instance.
+2. Create a dbt project and define your [`models`](/docs/build/models), [`seeds`](/reference/seed-properties), and [`tests`](/reference/commands/test).
+3. Use a scheduler such [Prefect](/docs/deploy/deployment-tools#prefect) to schedule your dbt runs. You can create a DAG (Directed Acyclic Graph) that triggers dbt commands at specified intervals.
+4. Write a script that runs your dbt commands, such as [`dbt run`](/reference/commands/run), `dbt test` and more so.
+5. Use your chosen scheduler to run the script at your desired frequency.
+
+
+
+Congratulations on making it through the guide 🎉!
+
+
+
+
+
+
+
diff --git a/website/static/img/icons/duckdb-seeklogo.svg b/website/static/img/icons/duckdb-seeklogo.svg
new file mode 100644
index 00000000000..1d684f4253c
--- /dev/null
+++ b/website/static/img/icons/duckdb-seeklogo.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/website/static/img/icons/white/duckdb-seeklogo.svg b/website/static/img/icons/white/duckdb-seeklogo.svg
new file mode 100644
index 00000000000..1d684f4253c
--- /dev/null
+++ b/website/static/img/icons/white/duckdb-seeklogo.svg
@@ -0,0 +1 @@
+
\ No newline at end of file
diff --git a/website/vercel.json b/website/vercel.json
index 993ff9065bd..8c0d8eccae1 100644
--- a/website/vercel.json
+++ b/website/vercel.json
@@ -17,6 +17,11 @@
"destination": "https://github.com/dbt-labs/docs.getdbt.com/blob/current/contributing/adding-page-components.md",
"permanent": true
},
+ {
+ "source": "/guides/codespace",
+ "destination": "/guides/duckdb",
+ "permanent": true
+ },
{
"source": "/docs/dbt-cloud-apis/sl-manifest",
"destination": "/reference/artifacts/sl-manifest",