---
title: "Get started locally"
description: "Run Artifact Server on a laptop and publish a first immutable artifact version."
---

> Documentation Index
> Fetch the complete documentation index at: https://artifactserver.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Get started locally

The local target runs directly on the host with SQLite, local blob storage, and loopback-only content origins. The loopback application gives the local owner browser access without a sign-in form. The source installation requires Node.js 24.12 or newer and pnpm 10.34.3.

> **Packaged release**
>
> The public download, checksum, and attestation commands will be added here on release day. Until then, run Artifact Server from this repository.

## Run from source

1. **Install dependencies**

```sh
git clone https://github.com/plannotator/artifact-server.git
cd artifact-server
pnpm install
```
2. **Start Artifact Server**

```sh
pnpm dev
```

   Open the printed URL. `pnpm dev` starts both the web application and API. Do not run `artifactserver open` as a second setup step. Run CLI commands from the checkout with `pnpm artifactserver <command>`.
3. **Publish from an agent**

   Connect the agent to the running development installation:

```sh
pnpm artifactserver connect --data .artifact-server
```

   Then install the Artifact Server skill:

```sh
npx skills add plannotator/artifact-server
```

   Then ask the agent to upload the finished file. In clients that expose skills as slash commands:

```text
/artifact-server upload that HTML design doc
```

   The agent returns the full-screen review link first.

## Local access behavior

Requests from the loopback application origin can obtain the local-owner session without a sign-in form. Remote access still requires authentication. Hosted and private-team deployments use their selected identity provider.

> **Loopback is the boundary**
>
> Do not expose the local-owner development target directly to another device or a public network. If Artifact Server must be reachable remotely, use a private-team deployment.

## Next

- [Choose a CLI or MCP publishing path](/docs/publish/index.md)
- [Learn the project and version model](/docs/concepts/mental-model/index.md)

Source: https://artifactserver.com/docs/get-started/index.mdx