Get started

Start the pinned Depsilo v0.11.0 Docker image, complete the protected first-run setup, and verify that the instance is ready.

On a machine with Docker installed, follow these steps to start stable v0.11.0, then confirm the connection with a dependency request.

From startup to your first request

Start Depsilo
Docker
```
docker run -d --name depsilo -p 23333:23333 \
  -v depsilo-state:/root/.depsilo \
  ghcr.io/depsilo/depsilo:0.11.0
```
The depsilo-state named volume mounts at the /root/.depsilo state root, so the absolute paths written by first-time setup keep the SQLite database and local cache in that same volume.

Here, localhost and 127.0.0.1 refer to the Docker host. From another device, use a server address it can reach and make sure port 23333 is accessible. For HTTPS or a reverse proxy, see Deployment and configuration.
Read the one-time bootstrap token
Terminal
```
docker logs depsilo
```
Copy the bootstrap token from the first startup log. Interactive setup requires it even when you open the page from localhost.
Create the first administrator

Open http://localhost:23333, enter the token, and choose an administrator username and strong password. v0.11.0 has no default administrator password.
Confirm the service is ready
Terminal
```
curl -fsS http://127.0.0.1:23333/ready
```
/ready checks SQLite and object storage. Wait for this command to succeed before changing package-manager configuration.
Send and find your first dependency request
终端窗口
```
curl -fsS http://127.0.0.1:23333/npm/is-number \
  -o /dev/null -w 'HTTP %{http_code}\n'
```
This reads npm package metadata without installing software or changing global registry settings. After receiving HTTP 200, open Admin → Access logs (/admin/logs). Find the npm is-number request by its timestamp and check its status and cache result.

Next, follow Verify cache reuse and download savings to download the same artifact twice and check whether the cache was reused.

Connect your first project

Open the Portal, select the package manager used by your project, and copy the configuration generated for the current instance address. The Portal displays and copies instructions; it does not change your machine or project files.

For a Python project, continue with Configure Python. See Connect package managers for every ecosystem.

Restart later

Current version boundaries

This guide installs stable v0.11.0. Homepage previews labeled “Development build” may show interface changes that have not been released. Use the matching documentation and release notes when installing or upgrading.