1
Fork 0
mirror of https://github.com/KoFish/pallium.git synced 2025-12-07 13:49:51 +00:00
[Pull Mirror] A Go implementation of a matrix.org homeserver
  • Go 99.6%
  • Shell 0.4%
Find a file
Krister Svanlund 1cbd5f88c8 Merge remote-tracking branch 'skaverat/master'
Conflicts:
	setup.sh
2015-01-15 21:15:21 +01:00
api Restructured the rest package 2015-01-05 20:58:41 +01:00
config Merge branch 'master' into api-restructure 2015-01-04 06:32:35 +01:00
matrix Added 'should be deleted' notices 2015-01-04 06:23:46 +01:00
objects Moved some code around and added setup.sh script 2015-01-06 03:23:57 +01:00
rest Moved some code around and added setup.sh script 2015-01-06 03:23:57 +01:00
storage Moved some code around and added setup.sh script 2015-01-06 03:23:57 +01:00
.gitignore Moved some code around and added setup.sh script 2015-01-06 03:23:57 +01:00
config.json.dist Merge branch 'master' into api-restructure 2015-01-04 06:32:35 +01:00
LICENSE Added Apache v2.0 license to the code 2014-11-04 01:13:05 +01:00
main.go Changed logging to log-module 2014-12-29 02:23:01 +01:00
README.md spell out that the webclient won't actually work yet 2015-01-03 18:16:54 +00:00
setup.sh fixing pwd issue 2015-01-15 21:03:37 +01:00
TODO Added case insensitive to TODO 2014-12-29 21:44:30 +01:00

pallium

Pallium is an experimental golang homeserver implementation for the Matrix.org standard.

Matrix is a new open standard for interoperable Instant Messaging and VoIP, providing pragmatic HTTP APIs and open source reference implementations for creating and running your own real-time communication infrastructure.

To get up and running:

# get the latest Go from https://golang.org/dl/
# and define a GOPATH for your Go workspace if you don't have one already:
export GOPATH=~/go
mkdir -p $GOPATH

# grab the latest pallium with all its dependencies:
go get github.com/KoFish/pallium

# set up a default config
cd $GOPATH/github.com/KoFish/pallium
cp config.json.dist config.json

# edit the hostname param in config.json to specify how the server
# should refer to itself and expect to be accessed from the internet
# (use localhost for local experimentation)

# set the server running. This will create a local sqlite db for storage
# and start listening for traffic.
$GOPATH/bin/pallium

To use the server, select a client from matrix.org. For instance, to use the webclient hosted at https://matrix.org/beta against your new server, just specify the URL of your pallium server (e.g. http://localhost:8008) as the "Home Server" parameter on the login and registration pages rather than http://matrix.org. You do not need to enter the captcha, as pallium does not support captcha-based registration yet.

Currently pallium does not support the full Matrix API set, so the webclient may well not work correctly

Alternatively, to run your own webclient:

git clone http://github.com/matrix-org/matrix-angular-sdk

...and follow the instructions in syweb/webclient/README

For more information on Matrix, please see Matrix.org, the Matrix Specification or Synapse - the Python reference Matrix home server implementation.