Skip to content

Commit 35d47e8

Browse files
author
potsables
committed
docs: update readme and makefile
1 parent 8110a4e commit 35d47e8

File tree

2 files changed

+11
-4
lines changed

2 files changed

+11
-4
lines changed

Makefile

Lines changed: 4 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,4 @@
11
GOCC ?= go
2-
IPFSVERSION=v0.4.18
32

43
.PHONY: install build gx
54

@@ -52,7 +51,6 @@ import:
5251
gx import github.com/ipfs/go-ipfs
5352

5453
.PHONY: vendor
55-
5654
vendor:
5755
# Nuke vendor directory
5856
rm -rf vendor
@@ -68,3 +66,7 @@ vendor:
6866

6967
# Remove problematic dependencies
7068
find . -name test-vectors -type d -exec rm -r {} +
69+
70+
.PHONY: ipfs
71+
ipfs:
72+
( cd vendor/github.com/ipfs/go-ipfs/cmd/ipfs ; go build ; cp ipfs $(GOPATH)/bin)

README.md

Lines changed: 7 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -32,14 +32,19 @@ config file is generated containing the i2p configuration and it's base32 and
3232
base64 addresses. This is stored in a file called "i2pconfig." Finally, it
3333
simply forwards the IPFS gateway to I2P.
3434

35-
Compiling
35+
Installation And Setup
3636
---------
3737

38+
The gotcha to the IPFS plugin system is that you'll need to run an IPFS node, that is using the same version of IPFS which was used to build the plugin.
39+
Due to `gx` being extensively used by the IPFS project, and it being hard to work with, you will not be able to use it with any IPFS daemon that wasn't built from the code within the `vendor/github.com/ipfs/go-ipfs` folder of this repository. This is somewhat undesirable, but it is the only way to reliably run this plugin. At the time of this commit, the go-ipfs commit we use is [df373ca3876ed4f706d8635c200c973f4189fcc6](https://github.com/ipfs/go-ipfs/commit/df373ca3876ed4f706d8635c200c973f4189fcc6). Over time hopefully we can imrpove this system, and make it usable with released versions of IPFS. As such, all dependencies are vendored with this repository.
40+
41+
To build the IPFS version needed to use this plugin run `make ipfs` which will copy the built `ipfs` binary to `$GOPATH/bin`. After that, the usual IPFS setup is needed which won't be covered here.
42+
3843
Running the deps target pulls in the dependencies, and the build target profile
3944
builds the plugin. Since there's no "main" function you can't "go get" the
4045
plugin package, you have to clone it.
4146

42-
git clone https://github.com/rtradeltd/go-ipfs-plugin-i2p-gateway
47+
git clone https://github.com/RTradeLTd/go-ipfs-plugin-i2p-gateway
4348
make deps build
4449

4550
Installing and Using it

0 commit comments

Comments
 (0)