# Local / Vps Deploy

### Requirements

* Debian Based Vps (Ubuntu etc.)
* Python 3.10+

{% stepper %}
{% step %}

### **Upgrade and Update:**

```bash
sudo apt-get update && sudo apt-get upgrade -y
```

{% endstep %}

{% step %}

### **Installing Required Packages:**

```bash
sudo apt-get install python3-pip ffmpeg -y
```

{% endstep %}

{% step %}

### **Setting up PIP**

```bash
sudo pip3 install -U pip
```

{% endstep %}

{% step %}

### **Installing Node**

{% code overflow="wrap" %}

```bash
curl -fssL https://deb.nodesource.com/setup_20.x | sudo -E bash - \
&& sudo apt-get install nodejs -y \
&& sudo npm i -g npm
```

{% endcode %}
{% endstep %}

{% step %}

### **Clone the Repository**

{% code overflow="wrap" %}

```bash
git clone https://github.com/xbitcode/StrangerMusicBot \
&& cd StrangerMusicBot
```

{% endcode %}
{% endstep %}

{% step %}

### Install tmux 

```bash
sudo apt-get install tmux
```

{% endstep %}

{% step %}

### Create a tmux session

creating a tmux session will make the bot run in backgroud , even  if you close the application.

```bash
tmux new -S stranger
```

{% endstep %}

{% step %}

### Setup Virtual Enviroment.

```bash
python -m venv .venv
```

{% endstep %}

{% step %}

### **Activate Venv and Install Requirements**

```bash
source .venv/bin/activate \
&& pip3 install -U -r requirements.txt
```

{% endstep %}

{% step %}

### **Create .env with sample.env**

```bash
cp sample.env .env
```

```bash
vi .env
```

`Edit .env with your vars` 

Edit .env with your values or you can simple copy a [config from here ](/stranger-music-docs/config-vars/editor.md)and paste it to your notepad, then edit and paste there.

Press `I` button on keyboard to start editing.

Press `Ctrl + C` once you are done with editing vars and type `:wq` to save .env or `:qa` to exit editing.
{% endstep %}

{% step %}

### Start the bot

```bash
bash start
```

{% endstep %}

{% step %}

### Finally Exit from Tmux session

`Ctrl + b  d`
{% endstep %}
{% endstepper %}

## Stopping the bot

{% stepper %}
{% step %}

### Launch the tmux session

* Launch the tmux session which have created during stating of the bot
* Example: my session name was starnger 

```bash
tmux a -t stranger
```

{% endstep %}

{% step %}

### Stop the bot 

* Option 1:\
  `Ctrl + c` 
* Option 2:\
  Forcefully terminate the bot \
  `Ctrl + \` 
* Option 3:\
  Forcefully terminate the process 

```bash
pkill -9 python
```

{% endstep %}

{% step %}

### Exit from tmux session

`Ctrl + b  d`

{% endstep %}
{% endstepper %}


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://stranger-organization.gitbook.io/stranger-music-docs/local-vps-deploy.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.