Quickstart

This guide takes you from signing up to a web service running at its own HTTPS address. It takes about 10 minutes.

Before you start

You need a GitHub repository with a web app in it. Appentic builds Python, Node.js, Bun, Go, Ruby and Rust apps, and anything with a Dockerfile.

1. Sign in

Go to app.appentic.com and choose Continue with Google or Continue with GitHub. Appentic creates your account and a workspace called Personal.

2. Add credits

Appentic is prepaid, and you need credits before you can choose a machine.

1. Open the user menu at the bottom of the sidebar and choose User settings, then Billing.
2. Click Add credits.
3. Pick an amount, click Add $… credits and pay on the Stripe checkout page.

The credits are added to your balance as soon as the payment goes through. See Adding credits.

3. Create a project

On the dashboard, click Create your first project, or New Project if you already have one. Enter a Project name and click Create Project. Appentic opens the project's Services page.

4. Choose a machine

1. In the project's sidebar, open Resources.
2. Pick a Geo, the location your project runs in. Choose the one closest to your users.
3. Pick a Machine. Shared CPU machines cost the least.
4. Click Choose machine and confirm.

Setting up takes a minute or two. The machine is billed from when it is set up until you remove it or delete the project. You can add more machines later. See Machines.

5. Connect GitHub

1. Open Services in the project's sidebar and click Add next to Web Services.
2. Click Connect GitHub and install the Appentic GitHub App on the account or organisation that owns your repository.

You can give the app access to all repositories or only the ones you pick. This is separate from signing in with GitHub, so you need it even if you signed in that way. See GitHub.

6. Deploy

1. Search for your repository and select it.
2. Check the Branch. With Auto-deploy on, every push to this branch deploys.
3. Appentic detects how to build your app and fills in the Runtime, Build command and Start command. Change them if they're wrong. If the repository has a Dockerfile at its root, Appentic builds that instead. See Builds.
4. Set Guaranteed memory with the slider. CPU and disk follow the same share of the machine. See Memory and sizing.
5. Click Deploy service.

Appentic opens the service's Events page, where you can follow the build and deploy. A first deploy usually takes 2 to 4 minutes.

7. Open your service

When the deploy is live, the service's Overview page shows its URL, for example https://my-app-313763cfb597.appentic.app. It's served over HTTPS, and you can choose a shorter name for it.

Next steps