modify docker

[bytom/vapor.git] / docs / Running-in-Docker.md

diff --git a/docs/Running-in-Docker.md b/docs/Running-in-Docker.md
new file mode 100644 (file)
index 0000000..09124ef
--- /dev/null
+++ b/docs/Running-in-Docker.md
@@ -0,0 +1,67 @@
+## Running in Docker
+
+### Build the image
+
+```bash
+$ docker build -t vapor .
+```
+
+### Init vapor
+
+```bash
+$ docker run -v <vapor/data/directory/on/host/machine>:/root/.vapor vapor:latest bytomd init --chain_id=vapor
+```
+
+The default Vapor data directory (on the host) is:
+
++ Mac: `~/Library/Vapor`
++ Linux: `~/.vapor`
++ Windows: `%APPDATA%\Vapor`
+
+### Enter the iterative mode
+
+```bash
+$ docker run -it --net=host -v <vapor/data/directory/on/host/machine>:/root/.vapor vapor:latest
+```
+
+Then you can use bytomd and bytomcli following [Readme](https://github.com/Bytom/bytom/blob/master/README.md)
+
+Use `exit` to exit Docker's iterative mode
+
+### Daemon mode
+
+For example,
+
+```bash
+$ docker run -d --net=host -v <vapor/data/directory/on/host/machine>:/root/.vapor vapor:latest bytomd node --web.closed --auth.disable
+```
+
+__To list the running containners and check their container id, image, corresponding command, created time, status, name and ports being used:__
+
+```bash
+$ docker container ls
+```
+
+or
+
+```bash
+$ docker ps
+```
+
+__To execute a command inside a containner, for example:__
+
+```bash
+$ docker exec -it <containerId> bytomcli create-access-token <tokenId>
+```
+
+__To stop a running containner:__
+
+```bash
+$ docker stop <containerId>
+```
+
+__To remove a containner:__
+
+```bash
+$ docker rm <containerId>
+```