Unhosted webapp client for Duniter network.
Demo: http://gtest.duniter.fr
To use Cesium from your desktop computer :
- Download the latest release. Choose the web packaging (
cesium-vX.Y.Z-we.zip); - Unpack in a empty directory;
- Open the
index.htmlfile in a web browser.
Cesium can be easily installed on most web server.
If you don't already use nodejs (v5), please follow prerequisite steps.
git clone https://github.com/duniter/cesium.git
cd cesium
npm install
npm startAnswer asked questions.
Your cesium instance is now reacheable on : http://localhost:8100/ or an other ip if your listen on an other interface.
For Linux distribution, a installation script could be used to:
- Download the latest release
- Unpack archive into the directory
./cesium. Existing files will be override.
curl -kL https://raw.githubusercontent.com/duniter/cesium/master/install.sh | bash
or:
wget -qO- https://raw.githubusercontent.com/duniter/cesium/master/install.sh | bash
Note: You may need root permission to write files. If so just replace | bash with | sudo bash.
There is a package for YunoHost self-hosting distribution.
To change default configuration:
- Edit the file
config.js, and set default properties:
angular.module("cesium.config",[]).constant("csConfig",{"fallbackLanguage": "en","rememberMe": false,"timeWarningExpireMembership": 5184000,"timeWarningExpire": 7776000,"useLocalStorage": true,"useRelative": true,"decimalCount": 4,"helptip": {"enable": true,"installDocUrl": "https://github.com/duniter/duniter/blob/master/doc/install-a-node.md"},"node": {"host": "gtest.duniter.org","port": "10900"},"plugins": {"es": {"enable": "false","host": "data.gtest.duniter.fr","port": "80"}},"version": "0.9.7","build": "2017-01-17T08:27:57.915Z"});Configure a Duniter node:
- set
node.hostandnode.portto the default node address.
- set
Configure the optional extension for ElasticSearch Duniter4j node
set
plugins.es.hostandplugins.es.portto the default ES node address.set
plugins.es.enablewith [true|false] to change the default extension state.
To learn more about configuration options, see the detailed documentation.
This software is distributed under GNU GPLv3.
To build Cesium, you will have to:
- Installing nvm
wget -qO- https://raw.githubusercontent.com/creationix/nvm/v0.31.0/install.sh | bash
- Configure NodeJS to use a version 5:
nvm install 5 - Installing nodejs build tools:
npm install -g bower gulp ionic@1.7.16 cordova
- Installing other build dependencies:
sudo apt-get install build-essential
- Getting source and installing project dependencies:
git clone https://github.com/duniter/cesium.git
cd cesium
npm install
bower install
- Installing Cordova plugins
ionic state restore
To configure your build environment :
Add your environment config into
app/config.jsonUpdate default configuration, using the command:
gulp config --env <your_env_name> This will update the configuration file used by cesium, at www/js/config.json.
- Compiling and running Cesium:
npm start
or
ionic serve
Cesium could be run on phone devices. Please read performance tips on AgularJS + Ionic before starting to contribute. Read also Angular performance for large applicatoins.
