gold

by linkeddata

linkeddata / gold

Linked Data server for Go

128 Stars 30 Forks Last release: Not found 663 Commits 2 Releases

Available items

No Items, yet!

The developer of this repository has not created any items for sale yet. Need a bug fixed? Help with integration? A different license? Create a request here:

gold

Join the chat at https://gitter.im/linkeddata/gold

gold
is a reference Linked Data Platform server for the Solid platform.

Written in Go, based on initial work done by William Waites.

Build Status

Installing

From docker repository:

sudo docker pull linkeddata/gold
sudo docker run -p ip:port:443 linkeddata/gold

Replace

ip
and
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.

From Github:

  1. Setup Go:
* **Mac OS X**: `brew install go`
* **Ubuntu**: `sudo apt-get install golang-go`
* **Fedora**: `sudo dnf install golang`
  1. Set the

    GOPATH
    variable (required by Go):
      mkdir ~/go
      export GOPATH=~/go
    

    (Optionally consider adding

    export GOPATH=~/go
    to your
    .bashrc
    or profile).
  2. Check that you have the required Go version (Go 1.4 or later):

      go version
    

    If you don't, please install a more recent version.

  3. Use the

    go get
    command to install the server and all the dependencies:
    go get github.com/linkeddata/gold/server
    
  4. Install dependencies:

    • Mac OS X:
      brew install raptor libmagic
    • Ubuntu:
      sudo apt-get install libraptor2-dev libmagic-dev
    • Fedora:
      sudo dnf install raptor2-devel file-devel
  5. (Optional) Install extra dependencies used by the tests:

    go get github.com/stretchr/testify/assert
    

Running the Server

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
$GOPATH/src/github.com/linkeddata/gold/
). Otherwise, make sure to pass it a dedicated data directory to serve, either using a command-line parameter or the config file. Something like:
-root=/var/www/data/
or
-root=~/data/
.
  1. If you installed it from package via
    go get
    , you can run it by:
  $GOPATH/bin/server -http=":8080" -https=":8443" -debug
  1. When developing locally, you can
    cd
    into the repo cloned by
    go get
    :
  cd $GOPATH/src/github.com/linkeddata/gold

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.
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:

~/go/bin/server -help

Some important options and defaults:

  • -conf
    - Optional path to a config file.
  • -debug
    - Outputs config parameters and extra logging. Default:
    false
    .
  • -root
    - Specifies the data root directory which
    gold
    will be serving. Default:
    .
    (so, likely to be
    $GOPATH/src/github.com/linkeddata/gold/
    ).
  • -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 alternative. Default:
    ":80"
    . Example:
    -http=":8080"
    .
  • -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 alternative. Default:
    ":443"
    . Example:
    -https=":8443"
    .

Testing

To run the unit tests (assuming you've installed

assert
via
go get github.com/stretchr/testify/assert
):
make test

Notes

License

MIT

We use cookies. If you continue to browse the site, you agree to the use of cookies. For more information on our use of cookies please see our Privacy Policy.