Deploy Your Own App from GitHub

If you or your developer wrote an app and keep the code on GitHub, App Hosting can put it online for you. An assistant reads your code and suggests the right size.

Only want a ready-made app? Use the Marketplace instead.

1. Private code? Add a GitHub token first

If your GitHub repository is private, the assistant needs permission to read it:

1. Open App Hosting > Credentials.
2. Click Add credential and add a GitHub Personal Access Token. Your developer can create one in GitHub.
3. It appears in the list with status ACTIVE.

Public repositories need nothing.

2. Start the Deploy assistant

1. Open App Hosting > Deploy.
2. Paste your GitHub link in the box (number 1), for example https://github.com/yourname/shop. You can also click an example (number 2).
3. Press Send (number 3).
4. The assistant checks the code, finds the type of app, and suggests a package. You can ask it questions in plain words, for example "Why the Medium tier?" or "Change the port to 8080".
5. Check the summary and the price, then confirm. Your app appears in Platforms.

3. Publish a new version

When your code on GitHub changes, open the app and click Deploy Update at the top. Follow progress in the Deployments tab.

4. Health Check: restart automatically when the app hangs

Open the app > Settings > Health Check (number 1). We regularly call your app to see if it is alive:

• Liveness (number 2): if the app stops answering, it is restarted automatically.
• Readiness (number 3): if the app is not ready, visitors are not sent to it for a moment.
• Startup: for apps that take a long time to start.

For each check you set the Path (for example / or /health), the Port, how long to wait before the first check, how often to check, and how many failures in a row count as "down". Your developer knows the right values. Click Save & apply. The app restarts gradually, visitors are not cut off. Reset to default brings back the original values.

5. Config Files: add settings files

Some apps need a settings file (for example nginx.conf or settings.yaml). Open Settings > Config Files and click + Add file:

1. Name (number 1): a short name, lowercase, for example nginx.
2. Folder in the app (number 2): where the file should appear, for example /etc/nginx.
3. File name (number 3): for example nginx.conf. Use + File to add more files in the same folder.
4. File content (number 4): the text of the file.
5. Read the warning (number 5): never put passwords or tokens here. Use a secret Environment Variable instead.
6. Click Save & apply (number 6). The app restarts gradually.

Summary

• Passwords go in Environment Variables, not in Config Files.