---
title: "Installation"
description: "Get started with Docus."
canonical_url: "https://docus.dev/en/getting-started/installation"
---
# Installation

> Get started with Docus.

## `create-docus` CLI

<steps>

### Create your docs directory

Use the `create-docus` CLI to create a new Docus project:

```bash [Terminal]
npx create-docus my-docs
```

You can choose between two templates:

- `default`: Basic Docus setup for single-language documentation
- `i18n`: Includes internationalization support for multi-language documentation

```bash [Terminal]
# Create with i18n template
npx create-docus my-docs -t i18n
```

We recommend using the `npm` package manager.

### Start your docs server in development

Move to your docs directory and start your docs server in development mode:

```bash [Terminal]
cd my-docs
npm run dev
```

A local preview of your documentation will be available at [http://localhost:3000](http://localhost:3000)

### Write your documentation

Head over the [Edition](https://docus.dev/en/concepts/edition) section to learn how to write your documentation.

</steps>

## AI Assistant Skill

Get started quickly with Docus by adding specialized knowledge to your AI assistant (Cursor, Claude, etc.):

```bash [Terminal]
npx skills add https://docus.dev
```

This skill helps you create documentation faster by providing your AI assistant with:

- Best practices for writing documentation with Docus
- MDC component usage and ready-to-use templates
- Writing guidelines and content structure patterns
- Configuration and customization tips

Once installed, your AI assistant can help you scaffold new documentation projects, generate pages with proper structure, and write content following Docus best practices.

<tip to="https://docus.dev/en/ai/skills">

You can also publish your own skills from your Docus site. Learn more about Agent Skills.

</tip>

## Layer Integration

Docus uses a **Nuxt layer-based approach**, you can extend the Docus layer directly in your `nuxt.config.ts` with `extends: ['docus']`:

```ts [nuxt.config.ts]
export default defineNuxtConfig({
  extends: ['docus']
})
```


## Sitemap

See the full [sitemap](https://docus.dev/sitemap.md) for all pages.