arcblock/blocklet-server repository overview
Blocklet Server
Blocklet Server is a comprehensive platform for deploying, managing, and running Blocklet applications. It provides a complete runtime environment with built-in authentication, routing, and lifecycle management.
Table of Contents
Quick Start
Using Docker (Recommended)
docker pull arcblock/blocklet-server
docker run -d -p 80:80 -p 443:443 -v ~/blocklet-data:/data arcblock/blocklet-server
Then open http://localhost to access the Blocklet Server dashboard.
Using npm
npm install -g @blocklet/cli
blocklet server start -a
System Requirements
| Requirement | Minimum | Recommended |
|---|---|---|
| Node.js | 20.x | 22.x or later |
| Memory | 2 GB | 4 GB or more |
| Disk Space | 10 GB | 50 GB or more |
| OS | Linux, macOS, Windows (Docker) | Linux (Ubuntu 20.04+) |
Supported Platforms
- Linux: Ubuntu 18.04+, Debian 10+, CentOS 7+
- macOS: 10.15+
- Windows: Windows 10+ (via Docker or WSL2)
Installation
Docker
We provide Docker images from multiple registries:
# Docker Hub (default)
docker pull arcblock/blocklet-server
# GitHub Container Registry
docker pull ghcr.io/arcblock/blocklet-server:latest
# AWS ECR
docker pull public.ecr.aws/i0s0w0c9/blocklet-server:latest
Run with persistent data:
docker run -d \
-p 80:80 \
-p 443:443 \
-v /path/to/your/data:/data \
arcblock/blocklet-server
From Source
git clone https://github.com/ArcBlock/blocklet-server.git
cd blocklet-server
bun install
bun run build
Packages
This monorepo contains the following packages:
Core Packages
| Package | Description |
|---|---|
| @blocklet/cli | Command-line interface |
| @blocklet/sdk | Node.js SDK for Blocklet development |
| @blocklet/js-sdk | Browser SDK |
Server Components
| Package | Description |
|---|---|
| @abtnode/core | Core server functionality |
| @abtnode/webapp | Web dashboard |
| @abtnode/auth | Authentication system |
| @abtnode/router-provider | Request routing |
Utilities
| Package | Description |
|---|---|
| @blocklet/logger | Logging utilities |
| @blocklet/store | State management |
| @blocklet/meta | Blocklet metadata |
Documentation
Contributing
We welcome contributions! Please see our Contributing Guide for details.
Getting Help
License
Copyright 2018-2026 ArcBlock
Licensed under the Apache License, Version 2.0. See LICENSE for details.
Tag summary
Content type
Image
Digest
sha256:c66f82a88…
Size
179.5 MB
Last updated
7 months ago
docker pull arcblock/blocklet-server