README.md 1.8 KB
Newer Older
1
2
3
4
5
6
7
8
# FairCoin.Co electrumfairchainsx server

electrumfairchainsx server for electrumfair(chains) wallets

The service is made for/controlled by gitlab runner.

## Usage

9
10
### by Gitlab-Runner

11
12
13
14
15
16
17
18
19
Go Gitlab **CI/CD** -> **Pipeline** and **Run Pipeline**

Enter variable name **CMD**

#### CMD - commands

~~~
build        # build container ( changes of Dockerfile )
start        # start container ( changes of scripts )
20
new_ssl      # create new ssl file for electrumx server
21
stop         # stop container
22
install      # runs build, start and new_ssl stages
23
24
25
26
27
28
29
30
31
32
33
34
35
36
uninstall    # remove container without to delete the data
remove       # remove all data
~~~


#### CI/CD Settings

Go Gitlab **Settings** -> **CI/CD** -> **Variables**

~~~
#### FairCoin.Co group variables ######################
FAIRCHAINS_CONF        # conf
~~~

37
38
39
40
41
### by SSH access <small>( manually without gitlab-runner )</small>

#### install docker and docker-compose ( https://docs.docker.com/compose/install/ )

#### clone this project
42

43
44
45
46
47
48
#### change configuration in ./env and ./env_file

#### Initialize env vars
~~~
chmod +x ./setenv.sh && . setenv.sh
~~~
49

50
#### Deployment stages
51

52
run command from project root folder
53
~~~
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
deploy/build
deploy/start
deploy/new_ssl
deploy/stop
deploy/install
deploy/uninstall
deploy/remove
~~~

#### Troubleshooting

some commands can be helpful getting shell access to container or get some status info
~~~
console/electrumx                   # get access to container of electrumfairchainsx server ( same as electrumfairchainsx )
console/electrumfairchainsx         # get access to container of electrumfairchainsx server
console/faircoin                    # get access to container of faircoind

console/ps                          # list containers status info
console/status                      # list all ports / processes and faircoind info
73
~~~