2018-05-16 15:24:26 +00:00
|
|
|
# ekster
|
|
|
|
|
|
|
|
|
|
a microsub server
|
2018-02-19 20:39:22 +00:00
|
|
|
|
|
|
|
|
|
2018-05-16 15:40:57 +00:00
|
|
|
|
|
|
|
|
## Warning!
|
|
|
|
|
|
2018-02-19 20:39:22 +00:00
|
|
|
Very alpha: no warranty.
|
2018-05-16 15:40:57 +00:00
|
|
|
|
|
|
|
|
## Install ekster
|
|
|
|
|
|
|
|
|
|
ekster is build using [go](https://golang.org). To be able to install ekster
|
|
|
|
|
you need a Go environment. Use these commands to install the programs.
|
|
|
|
|
|
|
|
|
|
go get -u github.com/pstuifzand/ekster/cmd/eksterd
|
|
|
|
|
go get -u github.com/pstuifzand/ekster/cmd/ek
|
|
|
|
|
|
|
|
|
|
### `eksterd`
|
|
|
|
|
|
|
|
|
|
The command `eksterd` is the main server program. It will run a Microsub server.
|
|
|
|
|
`eksterd` also needs a Redis server. It's used to temporarily remember the items.
|
|
|
|
|
|
|
|
|
|
The first time you should call the command
|
|
|
|
|
|
|
|
|
|
eksterd new
|
|
|
|
|
|
2018-05-16 15:45:06 +00:00
|
|
|
This will generate a configuration file `backend.json` where it remembers the feeds.
|
2018-05-16 15:40:57 +00:00
|
|
|
|
|
|
|
|
### `ek`
|
|
|
|
|
|
|
|
|
|
The command `ek` is the command line client for Microsub server. It is able to
|
|
|
|
|
call the different functions of the Microsub server. It isn't needed to use `eksterd`, but
|
|
|
|
|
it can be useful. It can also be used with other servers that implement Microsub.
|
|
|
|
|
|
2018-05-23 16:13:22 +00:00
|
|
|
ek connect <url>
|
|
|
|
|
|
|
|
|
|
Connect with `ek` to you microsub server. After that you can call `ek` to
|
|
|
|
|
control your microsub server. It should even work with other servers that
|
|
|
|
|
support microsub.
|
|
|
|
|
|
|
|
|
|
ek <command> options...
|
|
|
|
|
|
|
|
|
|
Commands:
|
|
|
|
|
|
|
|
|
|
channels list channels
|
|
|
|
|
channels NAME create channel with NAME
|
|
|
|
|
channels UID NAME update channel UID with NAME
|
|
|
|
|
channels -delete UID delete channel with UID
|
|
|
|
|
|
|
|
|
|
timeline UID show posts for channel UID
|
|
|
|
|
timeline UID -after AFTER show posts for channel UID starting from AFTER
|
|
|
|
|
timeline UID -before BEFORE show posts for channel UID ending at BEFORE
|
|
|
|
|
|
|
|
|
|
search QUERY search for feeds from QUERY
|
|
|
|
|
|
|
|
|
|
preview URL show items from the feed at URL
|
|
|
|
|
|
|
|
|
|
follow UID show follow list for channel UID
|
|
|
|
|
follow UID URL follow URL on channel UID
|
|
|
|
|
|
|
|
|
|
unfollow UID URL unfollow URL on channel UID
|
|
|
|
|
|
|
|
|
|
|
2018-05-16 19:45:19 +00:00
|
|
|
## backend.json
|
|
|
|
|
|
|
|
|
|
The `backend.json` file contains all information about channels, feeds and authentication.
|
|
|
|
|
When the server is not running you can make changes to this file to add or remove feeds.
|
|
|
|
|
This is not the easiest way, but it's possible.
|
|
|
|
|
|
|
|
|
|
When generating this file for the first time. It will contain a default
|
|
|
|
|
configuration. This can be changed (and perhaps should be changed).
|
|
|
|
|
The two parts that should be changed are:
|
|
|
|
|
|
|
|
|
|
"Me": "...",
|
|
|
|
|
"TokenEndpoint": "...",
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
The `Me` value should be set to the URL you use to sign into Monocle, or
|
|
|
|
|
Micropub client.
|
|
|
|
|
|
|
|
|
|
`TokenEndpoint` should be the `token_endpoint` you use for that domain,
|
|
|
|
|
`ekster` will check every 10 minutes, if the token is still valid. This could
|
|
|
|
|
be retrieved automatically, but this doesn't happen at the moment.
|
|
|
|
|
|
2018-05-16 19:38:24 +00:00
|
|
|
## Using Docker / Docker Compose
|
|
|
|
|
|
|
|
|
|
It's now also possible to use docker-compose to start a ekster server.
|
|
|
|
|
|
|
|
|
|
docker-compose pull
|
|
|
|
|
docker-compose run web new
|
|
|
|
|
docker-compose up
|
|
|
|
|
|
2018-05-23 16:13:22 +00:00
|
|
|
### Add a link on your website in the `<head>` tag
|
|
|
|
|
|
|
|
|
|
Add a link in the `<head>` tag to let the microsub client know where to find your server.
|
|
|
|
|
|
|
|
|
|
<link rel="microsub" href="https://microsub.example.com/microsub">
|
|
|
|
|
|
|
|
|
|
The domain name `microsub.example.com` needs to be replaced with the vhost that
|
|
|
|
|
you use to proxy the server.
|
|
|
|
|
|
|
|
|
|
The microsub server responds to the `/microsub` url with the micropub protocol.
|
|
|
|
|
You can use `ek` to talk to the endpoint.
|
|
|
|
|
|
