Installation

How to launch app

1. Decide where you will launch app.

You can launch app on your local pc or vps server. App needs stable connection to the internet. If you want to launch app on your pc you should note that you can't turn of your pc or let it go into sleep mode. That's why to run app on server is more comfortable.

2. Install app

For local run you need to install java on your pc first. Go to oracle web site and download JDK 21 which suits your OS!

To make it easier you can followe instructions how to do it.

After java is installed you need to download Messenger app.

3. Run app

After app is installed move it to any folder. Then you need to opent terminal/cmd by address of this folder. If you are using mac 👇

On windows you can do like this 👇 or you can watch tutorial on  👉 youtube 

After terminal by folder adress with a Messenger app file opened you need to launch it. To do it, you need to execute run comman with valid device identifier. 

Read "How to use" part to find where to get device id.

Command to execute 👇

java -jar messenger-1.0.0.jar --app.identifier=e7074d22-d056-4d5c-a026-acb619a26fc3

⚠️ Note Use your identifier instead one from example! On video is process of launching retweeter, but flow is absolutely the same for messenger. The only difference is in app and command for start.

For server launch

If you are using Windows server, start process will be same like for local use. If you are using linux server follow instructions bellow👇

1. Connect your linux server

ssh root@192.0.0.127

Use your login and password from server instead of root and 192.0.0.127

2. Install docker

⚠️ Note press y or yes when terminal ask

execute these commands one by one 👇

sudo apt update

sudo apt install apt-transport-https ca-certificates curl software-properties-common

curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add -

sudo add-apt-repository "deb [arch=amd64] https://download.docker.com/linux/ubuntu focal stable"

sudo apt install docker-ce

3. Download and run app

docker pull andyf22/messenger

docker run -d --name myapp-container -p 8082:8082 andyf22/messenger --app.identifier=6c1efba2-749b-47bc-91b2-4153c116bf64

⚠️ Note Use your identifier instead one from example

 

How can i restart app?

1. Stop the app

- For windows and local run.

 Press Control + C in your terminal with running app. After app stops execute start command again.

 

- For linux server

 Stop app 👇

docker stop myapp-container

 Delete app 👇

docker remove myapp-container

Update app 👇

docker pull andyf22/messenger

Start app 👇

docker run -d --name myapp-container -p 8082:8082 andyf22/messenger --app.identifier=6c1efba2-749b-47bc-91b2-4153c116bf64

⚠️ Note Use your identifier instead one from example

In video is restart of Retweeter app, restart for Messenger is the same, just write 👆commands

 

1.2 I want to restart my app on windows server or local pc but my port is busy.

⚠️ Note in the command bellow you should use port on which you run your app. Basically it is 8082 for messenger and 8083 for retweeter

netstat -ano | findstr :8082

You will receive PID identifier , use it instead of 7924

taskkill /PID 7924 /F

this will make your port free after what you can use app run command.

java -jar messenger-1.0.0.jar --app.identifier=e7074d22-d056-4d5c-a026-acb619a26fc3

1.3. I want to restart my app on mac/linux server or local pc but my port is busy.

⚠️ Note in the command bellow you should use port on which you run your app. Basically it is 8082 for messenger and 8083 for retweeter

lsof -i :8082

You will receive PID identifier , use it instead of PID

kill -9 PID

this will make your port free after what you can use app run command.

For local run 
java -jar messenger-1.0.0.jar --app.identifier=e7074d22-d056-4d5c-a026-acb619a26fc3

For server run

docker pull andyf22/messenger

docker run -d --name myapp-container -p 8082:8082 andyf22/messenger --app.identifier=6c1efba2-749b-47bc-91b2-4153c116bf64

⚠️ Note Use your identifier instead one from example