Server Setup

Opsætning af din egen server

Følg vejledningen nedenfor for at sætte din egen server op. Disse retningslinjer antager, at du er noget bekendt med Git og Github allerede.

Fork jbakse/p5.party or code-a-game/p5.party repository on Github. See here for more information about forking repositories.
Opret en Heroku konto og log ind.
Fra hoveddashboardet vælg New » Create New App
1. Indtast et navn til din app i App name. Du skal vælge dit eget, unikt navn.
2. Dit kontonavn skal allerede vises i feltet App owner.
3. Vælg den region, der er tættest på dig og dine brugere.
4. Klik Create app.
Du skal nu blive taget til fanen Deploy for projektet.
1. Vælg Github som Deployment method
2. Hvis du tilhører flere github organisationer, vælg den, du brugte til at fork repo.
3. Skriv en del af dit fork navn og tryk Search. Du bør se dit fork i den resulterende liste.
4. Klik Connect knappen ved siden af dit fork.
5. I Manual deploy skal du kontrollere, at master branch er valgt, og derefter klikke Deploy Branch.
6. Heroku vil trække kilden fra din branch og lancere serveren. Dette kan tage et par minutter.
7. Hvis alt gik godt, burde du nu have din egen server kørende på Heroku. Klik Open app for at åbne serveren i browseren.
  - Hvis serverstarten fungerede, vil du se "Endpoint not found".
  - Hvis det var mislykket, vil du se "There's nothing here, yet".
Peg din p5.party sketch til den nye server.
- Brug domænet for din server - noget som yourserver.herokuapp.com - når du kalder partyConnect() i din sketch.

Tillykke! Forhåbentlig virker din sketch nu med din nye server!

Vigtig information om teknologi

⚠️ Vigtigt: I øjeblikket bruger p5.party en deepstream server til backend. Bemærk at deepstream er i vedligeholdelses mode og kan modtage minimale opdateringer fremover. Det er usikkert, hvad dette betyder for p5.party. Det kan betyde, at migration til en anden backend vil være nødvendig i fremtiden. For nu har deepstream dog vist sig at være en pålidelig, stabil backend.

💰 Omkostninger: En Heroku server koster omkring 35 kr. om måneden at køre.

Setting Up Your Own Server

Follow the guide below to set up your own server. These guidelines assume that you are already somewhat familiar with Git and Github.

Fork jbakse/p5.party or code-a-game/p5.party repository on Github. See here for more information about forking repositories.
Create a Heroku account and log in.
From the main dashboard, select New » Create New App
1. Enter a name for your app in App name. You must choose your own unique name.
2. Your account name should already be shown in the App owner field.
3. Choose the region closest to you and your users.
4. Click Create app.
You should now be taken to the Deploy tab for your project.
1. Select Github as the Deployment method
2. If you belong to multiple github organizations, select the one you used to fork the repo.
3. Type part of your fork name and press Search. You should see your fork in the resulting list.
4. Click the Connect button next to your fork.
5. In Manual deploy, verify that the master branch is selected, then click Deploy Branch.
6. Heroku will pull the source from your branch and launch the server. This may take a few minutes.
7. If all went well, you should now have your own server running on Heroku. Click Open app to open the server in your browser.
  - If the server startup succeeded, you will see "Endpoint not found".
  - If it failed, you will see "There's nothing here, yet".
Point your p5.party sketch to the new server.
- Use the domain of your server - something like yourserver.herokuapp.com - when you call partyConnect() in your sketch.

Congratulations! Hopefully your sketch now works with your new server!

Important Technology Information

⚠️ Important: Currently, p5.party uses a deepstream server as the backend. Note that deepstream is in maintenance mode and may receive minimal updates going forward. It is uncertain what this means for p5.party. It could mean that migration to another backend will be necessary in the future. For now, however, deepstream has proven to be a reliable, stable backend.

💰 Costs: A Heroku server costs about $5 per month to run (approximately 35 DKK).