---
title: "Install"
description: "How to install and setup publish.dev"
url: "https://publish.dev/docs/install.md"
section: "Docs"
---

> Breadcrumbs: Docs > Install
> Sitemap: https://publish.dev/docs/sitemap.md
> LLMS index: https://publish.dev/docs/llms.txt

# Install

> **Beta**
>
> publish.dev is in beta. If you don't have an account, request a workspace setup at [publish.dev/new](https://publish.dev/new).

## CLI

The CLI helps you setup your site and configuration, runs a development server, and validates builds.

### Initialization

Run the init script to setup your repo.

```bash
npx @publish.os/cli@latest init
```

You can choose to start from scratch or a template.

Once scaffolded, you can run the development server and start building:

```bash
npx @publish.os/cli@latest dev
```

## Filesystem

Getting started with publish.dev is as simple as putting a folder in your repo.

```txt Your repo
app/                        # your repo
├── dashboard/              # any app that might be related to your content
└── ...
│
publish.os/
├── publish.os.config.json
└── docs/
    └── content/
        └── install.mdx
```

When you want more control or customization, simply author your own layouts, [pages](/docs/pages), or [components](/docs/components).

```txt Your repo
publish.os/
├── publish.os.config.json
├── theme.css
└── components/ui/
    └── button.tsx
└── docs/
    └── page.tsx
    └── content/
        └── install.mdx
```

## Continue reading
- Next: [Git Sync](https://publish.dev/docs/git-sync.md)

## Section links
- [Docs home](https://publish.dev/docs)
- [LLMS index](https://publish.dev/docs/llms.txt)
- [Sitemap](https://publish.dev/docs/sitemap.md)