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

# Quickstart

> Connect a server and deploy your first app from GitHub in about ten minutes.

You need a Symplax account, a GitHub repository with a web app in it, and a server. If you do
not have a server yet, Symplax can set one up for you.

**1. Create your account**

Sign up at [symplax.com](https://symplax.com/signup) and verify your email. The Free plan
needs no card.

**2. Add a server**

In the dashboard, go to **Servers** and add one:

* **Connect your own:** click **New Server**, **Connect existing server**, and enter its IP
  address and SSH login. Symplax signs in and sets everything up. Ubuntu or Debian works best.
  See [Connect a server](https://docs.symplax.com/servers/connect.md).
* **Buy one:** pick a size and pay by the hour from your wallet. It is ready in about a
  minute. See [Buy a server](https://docs.symplax.com/servers/buy-a-server.md).

**3. Connect GitHub**

Go to **Apps** and click to create an app. The first time, Symplax asks you to install its
GitHub app so it can read your repositories.

**4. Deploy**

Pick the repository, the branch and the server, then deploy. Symplax detects the framework,
or uses your `Dockerfile` if there is one, and follows the build live.

**5. Open your app**

When the deploy finishes, your app is live at its free `https://<app>.symplax.app` address.
Every push to the branch deploys again.

> [!TIP]
>
> Prefer the terminal? Run `npx symplax login`, then `npx symplax deploy` to deploy and follow
> the build without leaving it. See the [CLI](https://docs.symplax.com/cli/overview.md).

## Next steps

> **[Add a database](https://docs.symplax.com/databases/overview.md)**
>
> Create one on the same server and link it to your app.

> **[Environment variables](https://docs.symplax.com/apps/environment-variables.md)**
>
> Add secrets and settings, including ones needed at build time.

> **[Custom domain](https://docs.symplax.com/apps/domains.md)**
>
> Point your own domain at the app, with HTTPS set up for you.

> **[Invite your team](https://docs.symplax.com/teams/roles.md)**
>
> Work together with roles that decide who can see and change what.


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