Skip to content


Repository files navigation


OnePlace - smart client for Steem and Golos blockchains. As a basis we took Vue with SSR module for frontend and LoopBack for backend.


Clone the repository and install npm modules

git clone
cd oneplace && npm i

Install dependencies

This instruction is for debian based linux


Install NodeJS, we recommend using last LTS version and nvm for installation:

nvm install 8.9.4
nvm use 8.9.4

Also you need to install mysql and redis databases. Use Docker Compose with our docker-compose.yml or make manual install:

sudo apt-get update
sudo apt-get install mysql-server

This repository includes init sql script, you can use it for fast start.

# Insert int sql script to ypu mysql daemon
mysql -u root < ./server/data/mysql/mysql-init.sql
# Login Mysql
mysql -u root
# Create new mysql user
CREATE USER 'oneplace'@'localhost' IDENTIFIED BY 'password';
# config privileges
GRANT ALL PRIVILEGES ON oneplace.* TO 'oneplace'@'localhost'

Also you can use MySql WorkBench with our model file to extend sql schema.

sudo apt-get install redis


Edit /etc/redis/redis.conf after instal redis-server for work as daemon on localhost:

daemonise yes
port 6379

After you clone the repository and install dependencies you need to create configuration files.

cd server
# Main config file
cp config.sample.json config.json
# config for databases
cp datasources.sample.json datasources.json
  "postingWrapper": {
    "steemDomain": "steem node with HTTP JSON-RPC",
    "golosDomain": "golos node with HTTP JSON-RPC",
    "username": "APPLICATION USERNAME"

Build and start

We prepared npm commands for fast build and start services. First you must build client with you config.

# Build front-end part of repo
npm run build

For start instances we also recommend using PM2. See process.json.

pm2 start process.json

# start monitoring panel
pm2 monit

But you can also try manual start.

Manual start
# Start LoopBack-API server
npm start

# Start VueSSR server
npm run client

Please see package.json for more details.


This example is for nginx config file.

location /api {
  proxy_set_header Host $host;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Real-IP $remote_addr;
location ~* ^/(dist|static) {
  root /var/www/oneplace/data/www/;
  expires 7d;
location / {
  proxy_set_header Host $host;
  proxy_set_header X-Forwarded-For $proxy_add_x_forwarded_for;
  proxy_set_header X-Real-IP $remote_addr;

Coming soon

  • Cluster start and graceful reload, with zero downtime
  • Full coverage Unit (frontend side) and BDD(API) test with Karma, Mocha and PhantomJS
  • Continuous Integration and Auto Deploy
  • Git flow and release notes
  • Full documentation


To report a non-critical issue, please file an issue on this GitHub project.

If you find a security issue please report details to:

We will evaluate the risk and make a patch available before filing the issue.