Welcome
Getting Started
How to Guides
Application vs Blocklet
Create Blocklet
Compose Blocklets
Develop Blocklet
User and Passport
Communicate with DID Wallet
Blocklet Storage
Using Blocklet Preferences
Using Blocklet Logger
Add PWA Integration to Blocklet
Build blocklet for profit [deprecated]
Bundle your blocklet
Manage Blocklet Versions
Publish your blocklet to the world
Deploy your blocklet
Read/Write blockchain in blocklet
Operation your blocklet
Reference Guides
DID Connect
blocklet.yml
blocklet.js
Blocklet SDK (Node.js)
Blocklet SDK (Browser)
Blocklet Service
Blocklet CLI
Blocklet Server CLI
Blocklet UI
Blocklet GitHub Actions
Blocklet Studio
Blocklet Manager
Security
Performance
Developer Best Practices.
Known Issues or Limitations
Setup Blocklet Server
WebHooks
OAuth Server
Access Key
MCP Servers
Conceptual Guides
Frequently Asked Questions
Setup with Docker
Starting a server with Docker#
Step 1: Pull the mirror#
$ docker pull arcblock/blocklet-server:latest
Step 2: Start the container#
$ docker run --name test-server -d -p 80:80 -p 443:443 -v /tmp/test:/data arcblock/blocklet-server
Parameter explanation:
--name
Specify the name of the container.-d
Let the container run in the background.-p
Specify the ports exposed by the container. Blocklet Server will run on ports 80 and 443, so the container needs to be exposed to these two ports.-v
Mount the disk directory. data in Blocklet Server will be stored in the/data
directory, to prevent data loss, so the best practice is to mount the data directory in Docker to a directory on the host.
If everything is fine, Blocklet Server will start successfully within a minute, and you can use the docker logs {container name}
command to view the startup information in the container during the startup process:
$ docker logs test-server
Powered By
_ ____ _ _
/ \ _ __ ___| __ )| | ___ ___| | __
/ _ \ | '__/ __| _ \| |/ _ \ / __| |/ /
/ ___ \| | | (__| |_) | | (_) | (__| <
/_/ \_\_| \___|____/|_|\___/ \___|_|\_\
Blocklet CLI v1.8.22
blocklet server v1.8.22
Blocklet Server instance already exists in /data, now starting...
✔ Blocklet Server DB Proxy ready on port 40404
ℹ Node DID from config zNKZ5v8AqMfNrZoTrdComvjZdGKkjrDqALPx
ℹ Node config from /data/.blocklet-server/config.yml
✔ Blocklet Server Event Hub ready on port 40407
✔ Blocklet Server Updater ready on port 40405
✔ Fetch wildcard certificates successfully
- Starting Blocklet Service...
✔ Starting Blocklet Service... Done in 21.351s
- Starting Blocklet Server Daemon...
✔ Starting Blocklet Server Daemon... Done in 29.49s
Step 3: Access the server via IP Echo address#
IP Echo is a DNS that maps IPs in URLs, and the domain name served by IP Echo is ip.abtnet.io
. For example, https://192-168-1-1.ip.abtnet.io
DNS resolves the IP to 192.168.1.1
.
The server can be accessed through the IP Echo address after the server is successfully started. For example, if the local IP is 192.168.0.10
, then the IP Echo address is https://192-168-0-10.ip.abtnet.io/
.