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

# Quick start

> From database setup to launching the blog and admin console.

This guide gets you to a minimal running BlogLoom: initialize the database, start the backend, then launch the admin console and the public blog.

> Prefer not to install JDK and Node.js on the server? See [Docker deployment](/v1/en/deploy/docker) for a one-command start.

## Prerequisites

* JDK 8 or later
* Maven 3.6+
* Node.js 16+ and npm
* MySQL 5.7+ or MySQL 8

## 1. Initialize the database

```sql theme={null}
CREATE DATABASE blogloom
  CHARACTER SET utf8mb4
  COLLATE utf8mb4_unicode_ci;
```

Copy the config template and fill in the database connection:

```bash theme={null}
cp bin/local/deploy.conf.example bin/local/deploy.conf
```

Then run the incremental SQL to initialize:

```bash theme={null}
bin/local/upgrate-sql.sh --dry-run   # preview pending SQL
bin/local/upgrate-sql.sh             # execute and record
```

The script runs the scripts under `sql/increment/` in timestamp order (the baseline includes the schema) and writes execution records to `sql/local/`, so it is safe to rerun. See [Initialize the database](/v1/en/deploy/database) for details.

## 2. Configure and start the backend

Local development config lives at:

```text theme={null}
blog-backend/src/main/resources/application-dev.properties
```

Check the database, `token.secretKey` and URL settings, then run:

```bash theme={null}
cd blog-backend
mvn spring-boot:run
```

The backend listens on `8090`.

## 3. Start the admin console

```bash theme={null}
cd blog-cms-ui
npm install
npm run dev
```

Open `http://localhost:8079` and sign in with the default account:

```text theme={null}
username: admin
password: 123456
```

## 4. Start the public blog

```bash theme={null}
cd blog-view-ui
npm install
npm run dev
```

Open `http://localhost:8080` to view the site.

## Next steps

* [Architecture](/v1/en/guide/architecture)
* [Content model](/v1/en/guide/concepts/content-model)
* [Deploy](/v1/en/deploy/index)
* [FAQ](/v1/en/guide/reference/faq)