gold is a reference Linked Data Platform server for the
Written in Go, based on initial work done by William Waites.
sudo docker pull linkeddata/gold sudo docker run -p ip:port:443 linkeddata/gold
port with your host computer's IP address and port number.
To check the status of the container, type:
sudo docker ps
IMPORTANT: if you want to mount a host directory into the container, you can use the -v parameter:
sudo docker run -p ip:port:443 -v /home/user/data:/data linkeddata/gold
This will mount the host directory,
/home/user/data, into the container as the
/data/ directory. Doing this will allow you to reuse the data directory without worrying about persistence inside the container.
brew install go
sudo apt-get install golang-go
sudo dnf install golang
GOPATH variable (required by Go):
mkdir ~/go export GOPATH=~/go
(Optionally consider adding
export GOPATH=~/go to your
.bashrc or profile).
Check that you have the required Go version (Go 1.4 or later):
If you don't, please install a more recent version.
go get command to install the server and all the dependencies:
go get github.com/linkeddata/gold/server
Mac OS X:
brew install raptor libmagic
sudo apt-get install libraptor2-dev libmagic-dev
sudo dnf install raptor2-devel file-devel
(Optional) Install extra dependencies used by the tests:
go get github.com/stretchr/testify/assert
IMPORTANT: Among other things,
gold is a web server. Please consider
running it as a regular user instead of root. Since gold treats all files
equally, and even though uploaded files are not made executable, it will not
prevent clients from uploading malicious shell scripts.
Pay attention to the data root parameter,
-root. By default, it will serve
files from its current directory (so, for example, if you installed it from
Github, its data root will be
Otherwise, make sure to pass it a dedicated data directory to serve, either
using a command-line parameter or the config file.
go get, you can run it by: ```
$GOPATH/bin/server -http=":8080" -https=":8443" -debug
2. When developing locally, you can `cd` into the repo cloned by `go get`:
And launch the server by:
go run server/*.go -http=":8080" -https=":8443" -debug -boltPath=/tmp/bolt.db
Alternatively, you can compile and run it from the source dir in one command:
go run $GOPATH/src/github.com/linkeddata/gold/server/*.go -http=":8080" -https=":8443"
-root=/home/user/data/ -debug -boltPath=/tmp/bolt.db
## Configuration You can use the provided `gold.conf-example` file to create your own configuration file, and specify it with the `-conf` parameter. ```bash cd $GOPATH/src/github.com/linkeddata/gold/ cp gold.conf-example server/gold.conf # edit the configuration file nano server/gold.conf # pass the config file when launching the gold server $GOPATH/bin/server -conf=$GOPATH/src/github.com/linkeddata/gold/server/gold.conf
To see a list of available options:
Some important options and defaults:
-conf - Optional path to a config file.
-debug - Outputs config parameters and extra logging. Default:
-root - Specifies the data root directory which
gold will be serving.
. (so, likely to be
-http - HTTP port on which the server listens. For local development,
the default HTTP port,
80, is likely to be reserved, so pass in an
-https - HTTPS port on which the server listens. For local development,
the default HTTPS port,
443, is likely to be reserved, so pass in an
To run the unit tests (assuming you've installed
go get github.com/stretchr/testify/assert):