> ## Documentation Index
> Fetch the complete documentation index at: https://docs.echoauth.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Discord-bottihostingin asennusopas

> Rekisteröidy, lunasta lisenssi ja saa Node.js- tai Python-Discord-bottisi käyntiin ja vastaanottamaan webhookeja EchoAuth Bothostingissa.

EchoAuth Bothosting ajaa Discord-bottisi omassa kontissaan osoitteessa [bothosting-eu01.echoauth.dev](https://bothosting-eu01.echoauth.dev). Käytössäsi on laskutuspaneeli tilillesi ja krediiteille sekä [Pterodactyliin](https://pterodactyl.io) perustuva hallintapaneeli itse palvelimelle (konsoli, tiedostot ja käynnistysasetukset).

Tämä opas käy läpi koko prosessin: tilin luomisen, lisenssin lunastamisen, palvelimen luomisen, botin lataamisen ja webhookien vastaanottamisen.

## Pika-aloitus

1. [Luo tilisi](#luo-tilisi) osoitteessa [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register)
2. [Lunasta lisenssisi](#lunasta-lisenssisi) Store-sivulla lisätäksesi krediittejä
3. [Luo palvelin](#luo-palvelin) — valitse ajoympäristö, nimeä se ja vahvista
4. [Lataa bottisi tiedostot](#lataa-bottisi-tiedostot) ja aseta käynnistysmuuttujat
5. [Käynnistä palvelin ja testaa webhook](#kaynnista-palvelin)

> [!NOTE]
>
> **Varmista ennen aloittamista, että sinulla on:**
>
> * Lisenssikoodi (ostovahvistussähköpostista hosting-ajan ostamisen jälkeen)
> * Bottisi koodi — Node.js:n `index.js` tai Pythonin `app.py` sekä Pythonin `requirements.txt`, jos sinulla on riippuvuuksia

## Luo tilisi

Siirry osoitteeseen [control-hosting.echoauth.dev/register](https://control-hosting.echoauth.dev/register), luo tili ja kirjaudu sisään. Päädyt Dashboardiin, joka näyttää palvelinten määrän ja krediittisaldon.

![EchoAuth Bothostingin hallintapaneeli kirjautumisen jälkeen, 0 palvelinta ja 0,00 krediittiä](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/01-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44a55bf2156a5be753248292b30a0ffa)

Hallintapaneeli heti kirjautumisen jälkeen: 0 palvelinta, 0 krediittiä.

## Lunasta lisenssisi

Avaa sivupalkista **Store**, napsauta **Redeem code** ja syötä lisenssikoodisi.

> [!TIP]
>
> 1 krediitti = 1 kuukausi ajoaikaa yhdelle bottikontille, eikä kontteja ole rajoitettu — jokainen tarvitsee vain tarpeeksi krediittejä kuukausikustannukseensa.

![Store-sivu, jossa 1, 6 ja 12 kuukauden lisenssivaihtoehdot ja Redeem code -painike](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/02-store.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d22be1809910deac312b6cc81cc0708f)

Store-sivu, jossa Redeem code -painike ja hinnoittelu 1 krediitti = 1 kuukausi.

![Redeem voucher code -ikkuna, johon on syötetty lisenssikoodi](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/03-redeem-filled.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=5e5333a498707f29e30f975978eef72b)

Lisenssikoodi syötettynä Redeem voucher code -ikkunaan.

Lunastuksen jälkeen krediitti lisätään saldoosi heti ja se kirjataan hallintapaneelin Activity Logsiin.

![Lunastusikkuna, jossa onnistumisviesti: 1,00 krediittiä lisätty](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/04-redeem-success.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=a79d87f20c1c7ebed2268dbdcbecd925)

Onnistunut lunastus lisää krediitin saldoosi heti.

## Luo palvelin

Siirry kohtaan **Servers** ja napsauta **Create Server**. Anna nimi ja valitse **Language**: **Node.js** tai **Python**. Sijainti ja resurssipaketti (**Bot Container** -tuote: 0,3 vCPU, 256 Mt RAM, 512 Mt levytilaa, 1 varmuuskopio, 1 portti, 1 krediitti/kk) täyttyvät automaattisesti.

![Palvelimen luontilomake, jossa nimi täytettynä, Node.js valittuna ja Bot Container -paketin tiedot alla](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/05-create-server.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=d2eca2740ee95cbaf0c73a1282542ab0)

Palvelimen luontilomake, Node.js valittuna, Bot Container -paketti ja hinta näkyvissä.

Napsauta **Create server**. Summa veloitetaan krediittisaldostasi heti, ja palvelin näkyy Servers-sivulla tilassa **Active**.

![Palvelinkortti, jossa tila Active, määrittely Node.js, resurssipaketti Bot Container ja hinta 1,00 krediittiä kuukaudessa](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/06-server-active.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8efdd67bc293af11210788908d4f7f12)

Uusi palvelin, aktiivinen ja laskutettu 1,00 krediittiä kuukaudessa.

## Tutustu hallintapaneeliin

Napsauta palvelinkortin kiintoavainkuvaketta avataksesi palvelimen hallintapaneelissa osoitteessa [controlpanel.echoauth.dev](https://controlpanel.echoauth.dev). Paneelissa on välilehdet **Console**, **Files**, **Databases**, **Schedules**, **Users**, **Backups**, **Network**, **Startup**, **Settings** ja **Activity**.

![Pterodactyl-paneelin etusivu, jossa vastaluotu palvelin](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/07-panel-dashboard.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=338631775f65f91731e5077d1d39bd43)

Hallintapaneelin palvelinlista, kun se avataan hallintapaneelista.

Uusi palvelin on aluksi offline-tilassa ja tiedostonhallinta on tyhjä odottamassa koodiasi.

![Console-välilehti, jossa palvelin on offline sekä Start-, Restart- ja Stop-painikkeet](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/08-console-offline.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=065bea5d4fd06fd09ed92566554b0b8f)

Console-välilehti palvelimella, jota ei ole vielä käynnistetty.

![Tyhjä tiedostonhallinta, jossa /home/container-hakemisto ilman tiedostoja](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/09-files-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=1bb3ee4e94d3e98217f508c56db8fa4d)

Tiedostonhallinta juuri luodulla palvelimella.

## Lataa bottisi tiedostot

Avaa ensin **Startup**-välilehti nähdäksesi, mitä ajoympäristösi odottaa.

> [tab] Node.js
>
> Käynnistyskomento ajaa `${MAIN_FILE}`-tiedoston hakemistosta `/home/container`. **Main File** -muuttujan oletusarvo on **`index.js`** — jos pääsi tiedoston nimi on eri, päivitä muuttuja vastaamaan sitä (se voi olla `.js` tai `.ts`).
>
> ![Startup-välilehti, jossa Node.js:n käynnistyskomento ja Docker-kuvan pudotusvalikko asetettuna arvoon Nodejs 26](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/10-startup-command.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=44f941a8fa4f4797b6d95348d78b4af3)
>
> Node.js:n käynnistyskomento ja Docker-kuvan valinta.
>
> ![Main File -käynnistysmuuttuja, oletusarvo index.js](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/11-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=373d4355cf41af1cf989e5cc5e1f1d8b)
>
> Main File -muuttuja, oletuksena index.js.
>
> Node.js-ajoympäristössä ei ole erillistä HTTP/HTTPS-kytkintä — koodisi päättää, kumpaa se kuuntelee.

> [tab] Python
>
> Käynnistyskomento ajaa aina tiedoston **`app.py`** hakemistosta `/home/container` — nimeä pääsi tiedosto täsmälleen näin ("App Py File" -muuttuja on vain kuvaileva, eikä sitä sijoiteta varsinaiseen komentoon).
>
> ![App Py File -käynnistysmuuttuja, oletusarvo app.py](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/19-python-main-file.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=0a2a66543153c5bf520179357ef7d1a5)
>
> Pythonin App Py File -muuttuja, jonka on pysyttävä arvossa app.py.
>
> Python-ajoympäristössä on myös **Use HTTPS** -kytkin: `0` = HTTP (oletus) ja `1` = HTTPS, jolloin se etsii palvelinhakemistostasi tiedostoja `cert.pem` ja `key.pem` ja käyttää itse allekirjoitettua varmennetta, jos niitä ei löydy.
>
> ![Use HTTPS -käynnistysmuuttuja, kytkin pois päältä, kuvaus 0 = HTTP oletus, 1 = HTTPS](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/20-python-use-https.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=eb21f9df848c94c86d160a8158528de1)
>
> Use HTTPS -muuttuja, saatavilla vain Python-ajoympäristössä.
>
> > [!WARNING]
> >
> > Julkinen HTTPS-webhook-proxy (alla) odottaa bottisi kuuntelevan pelkkää HTTP:tä. Jätä **Use HTTPS** arvoon `0`, ellet päätä TLS:ää itse ja yhdistä suoraan porttiisi.
>
> Luettele botin tarvitsemat paketit tiedostoon **`requirements.txt`** — ne asennetaan automaattisesti käynnistyksen yhteydessä.

Avaa **Files**, napsauta **New File** (tai **Upload** lähettääksesi tiedoston tietokoneeltasi) ja lisää koodisi.

![Uuden tiedoston editori, johon on liitetty esimerkki webhook-palvelimen koodista](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/12-new-file-editor.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=202c32cf6ecd7d4021aa46cd952ba328)

Botin koodin kirjoittaminen suoraan paneelin tiedostoeditorissa.

> [tab] Node.js
>
> ![Tiedostonhallinta, jossa index.js hakemistossa /home/container](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/13-files-index-js.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=ed83b61d895d03949133422c43be0ce0)
>
> index.js ladattu ja valmis ajettavaksi.

> [tab] Python
>
> ![Tiedostonhallinta, jossa app.py ja requirements.txt hakemistossa /home/container](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/21-python-files.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=8fb281d9be6156356abed7fcb9b1c0c6)
>
> app.py ja requirements.txt ladattu ja valmiina ajettavaksi.

## Käynnistä palvelin

Siirry kohtaan **Console** ja napsauta **Start**. Paneeli hakee Docker-kuvan, ajaa käynnistyskomennon ja näyttää tulosteen reaaliajassa.

![Konsoli, jossa käynnistysskripti ajetaan ja sen jälkeen Bot webhook server listening on port 25500](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/14-console-running.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=f118d50404f795183ec1dd8b0b1ef499)

Konsolin tuloste heti Node.js-palvelimen käynnistyksen jälkeen, botti kirjaa kuuntelevansa.

## Etsi palvelimesi osoite ja portti

Avaa **Network**-välilehti. Palvelimesi julkinen osoite on `<hostname>:<port>` — esimerkiksi `bothosting-eu01.echoauth.dev:25500`. Sallitut portit ovat väliltä `25500`–`25650`.

![Network-välilehti, isäntänimi bothosting-eu01.echoauth.dev ja portti 25500](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/15-network-tab.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=72e0554fadab4528c1cbd9a90b694380)

Network-välilehti, jossa palvelimen isäntänimi ja määritetty portti.

## Vastaanota webhookeja

Bottiisi pääsee ulkopuolelta kahdella tavalla:

| Muoto | URL | Huomautuksia |
| - | - | - |
| Suora HTTP | `http://bothosting-eu01.echoauth.dev:<port>/<path>` | Osuu suoraan konttisi porttiin. |
| HTTPS-proxy | `https://bothosting-eu01.echoauth.dev/hook/<port>/<path>` | TLS päätetään puolestasi — vaatii bottisi olevan HTTP-tilassa (`Use HTTPS = 0`). |

```bash Direct HTTP theme={null}
curl -X POST http://bothosting-eu01.echoauth.dev:25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

```bash HTTPS proxy theme={null}
curl -X POST https://bothosting-eu01.echoauth.dev/hook/25500/webhook \
  -H "Content-Type: application/json" \
  -d '{"event": "ping"}'
```

Molemmat palauttavat saman vastauksen yllä olevalta esimerkkibotilta:

```json theme={null}
{"status": "ok", "received": true}
```

...ja molemmat kutsut näkyvät reaaliajassa konsolissa yhdessä palvelimen suorittimen, muistin ja käyttöajan tilastojen kanssa.

![Konsoli, jossa kaksi Webhook received -lokiriviä sekä Address-, Uptime-, CPU Load- ja Memory-tilastoruudut](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/16-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9da134cabf2ca3125e723ba7374ebc3b)

Kaksi webhook-toimitusta kirjattuna reaaliajassa konsoliin, resurssitilastot alla.

Sama toimii päästä päähän Python-ajoympäristössä:

![Pythonin konsoliloki, jossa palvelimen käynnistys ja sen jälkeen kaksi Webhook received -riviä kahdesta eri lähde-IP:stä](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/22-python-webhook-logs.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=59e609ce210b24b4f1811e9e4300c632)

Python-botti kirjaa vastaanotetun webhookin sekä suoran portin että HTTPS-proxyn kautta.

## Hallitse palvelintasi

Käytä Console-välilehden **Restart**- ja **Stop**-painikkeita käynnissä olevan prosessin hallintaan.

### Varmuuskopiot

Bot Container -pakettisi sisältää 1 varmuuskopiopaikan. Avaa **Backups** ja napsauta **Create Backup** tallentaaksesi tiedostoistasi tilannekuvan.

![Backups-välilehti, jossa ei tallennettuja varmuuskopioita ja Create Backup -painike](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/17-backups-empty.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=9770bee3f420389ffac1676a6999477e)

Ei vielä varmuuskopioita — Backups-välilehti uudella palvelimella.

![Varmuuskopiolista, jossa yksi muutama sekunti sitten luotu varmuuskopio, 1/1 varmuuskopiota käytössä](https://mintcdn.com/echoauth/bj_a1F8xj-bFCqK4/images/bothosting-setup/18-backup-created.jpg?fit=max\&auto=format\&n=bj_a1F8xj-bFCqK4\&q=85\&s=7ccf5835b8ca402d763fac7997c4ffbe)

Ensimmäinen varmuuskopio luotu ja valmis.

### Uusi lisenssisi

Osta tai lunasta toinen lisenssikoodi samalla tavalla kuin kohdassa [Lunasta lisenssisi](#lunasta-lisenssisi) — lisätyt krediitit kattavat palvelimesi seuraavan kuukausilaskutusjakson automaattisesti.

## Vianetsintä

> [accordion] Palvelin ei käynnisty
>
> Tarkista **Startup**-välilehti: Node.js:ssä **Main File** -muuttujan on vastattava ladatun tiedoston nimeä täsmälleen, ja Pythonissa pääsi tiedoston nimen on oltava `app.py`. Puuttuva tai väärin nimetty tiedosto on yleisin syy.

> [accordion] Porttiin ei saa yhteyttä
>
> Käytä täsmälleen **Network**-välilehdellä näkyvää isäntänimeä ja porttia, älä itse valitsemaasi porttia — vain määritetty portti (`25500`–`25650`) reititetään konttiisi.

> [accordion] Webhook ei saavu perille
>
> Varmista, että käytät botin tilaan sopivaa muotoa: HTTPS-proxy (`/hook/<port>/<path>`) toimii vain, kun bottisi kuuntelee pelkkää HTTP:tä (`Use HTTPS = 0` Pythonissa). Tarkista myös, että polku vastaa koodisi odottamaa — kirjoitusvirhe palauttaa 404:n omalta palvelimeltasi, ei EchoAuthilta.

> [accordion] Yhä jumissa?
>
> Avaa sivupalkista **Support Ticket** ja kerro palvelimesi nimi sekä se, mitä olet kokeillut.

## UKK

> [accordion] Kuinka monta palvelinta voin ajaa?
>
> Niin monta kuin krediittisaldosi riittää — jokainen Bot Container maksaa 1 krediitin (1 kuukausi) ja laskutetaan kuukausittain saldostasi.

> [accordion] Voinko käyttää TypeScriptiä Node.js-ajoympäristössä?
>
> Kyllä — aseta **Main File** `.ts`-tiedostoksi, niin se ajetaan `tsx`:llä `node`:n sijaan.

> [accordion] Tarvitsenko Pythonissa requirements.txt-tiedoston, jos minulla ei ole riippuvuuksia?
>
> Et — se on valinnainen. Jos se on olemassa, sen paketit asennetaan jokaisen käynnistyksen yhteydessä; jos bottisi käyttää vain vakiokirjastoa, voit jättää sen pois.

> [accordion] Mitä tapahtuu, jos lisenssini loppuu?
>
> Lunasta uusi lisenssikoodi Store-sivulla ennen kuin krediittisi loppuvat — lisätyt krediitit otetaan käyttöön seuraavalla laskutusjaksolla automaattisesti.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.