Skip to content
This repository was archived by the owner on Feb 12, 2024. It is now read-only.

Commit 9697fe3

Browse files
victorbdryajov
authored andcommitted
docs: Add Docker to README (#1240)
1 parent a935670 commit 9697fe3

File tree

1 file changed

+33
-0
lines changed

1 file changed

+33
-0
lines changed

README.md

Lines changed: 33 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -67,6 +67,7 @@ You can check the development status at the [Waffle Board](https://waffle.io/ipf
6767
- [Node Management](#node-management)
6868
- [Domain data types](#domain-data-types)
6969
- [FAQ](#faq)
70+
- [Running js-ipfs with Docker](#running-js-ipfs-with-docker)
7071
- [Packages](#packages)
7172
- [Development](#development)
7273
- [Clone and install dependencies](#clone-and-install-dependencies)
@@ -507,6 +508,38 @@ HOME=~/.electron-gyp npm install
507508

508509
If you find any other issue, please check the [`Electron Support` issue](https://github.com/ipfs/js-ipfs/issues/843).
509510

511+
## Running js-ipfs with Docker
512+
513+
We have automatic Docker builds setup with Docker Hub: https://hub.docker.com/r/ipfs/js-ipfs/
514+
515+
All branches in the Github repository maps to a tag in Docker Hub, except `master` Git branch which is mapped to `latest` Docker tag.
516+
517+
You can run js-ipfs like this:
518+
519+
```
520+
$ docker run -it -p 4002:4002 -p 4003:4003 -p 5002:5002 -p 9090:9090 ipfs/js-ipfs:latest
521+
522+
initializing ipfs node at /root/.jsipfs
523+
generating 2048-bit RSA keypair...done
524+
peer identity: Qmbd5jx8YF1QLhvwfLbCTWXGyZLyEJHrPbtbpRESvYs4FS
525+
to get started, enter:
526+
527+
jsipfs files cat /ipfs/QmfGBRT6BbWJd7yUc2uYdaUZJBbnEFvTqehPFoSMQ6wgdr/readme
528+
529+
Initializing daemon...
530+
Using wrtc for webrtc support
531+
Swarm listening on /ip4/127.0.0.1/tcp/4003/ws/ipfs/Qmbd5jx8YF1QLhvwfLbCTWXGyZLyEJHrPbtbpRESvYs4FS
532+
Swarm listening on /ip4/172.17.0.2/tcp/4003/ws/ipfs/Qmbd5jx8YF1QLhvwfLbCTWXGyZLyEJHrPbtbpRESvYs4FS
533+
Swarm listening on /ip4/127.0.0.1/tcp/4002/ipfs/Qmbd5jx8YF1QLhvwfLbCTWXGyZLyEJHrPbtbpRESvYs4FS
534+
Swarm listening on /ip4/172.17.0.2/tcp/4002/ipfs/Qmbd5jx8YF1QLhvwfLbCTWXGyZLyEJHrPbtbpRESvYs4FS
535+
API is listening on: /ip4/0.0.0.0/tcp/5002
536+
Gateway (readonly) is listening on: /ip4/0.0.0.0/tcp/9090
537+
Daemon is ready
538+
539+
$ curl --silent localhost:5002/api/v0/id | jq .ID
540+
"Qmbd5jx8YF1QLhvwfLbCTWXGyZLyEJHrPbtbpRESvYs4FS"
541+
```
542+
510543
## Packages
511544

512545
| Package | Version | Deps | DevDeps | Travis | Circle | AppVeyor | Coverage |

0 commit comments

Comments
 (0)