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

# Installation

> A step-by-step guide to get LaunchKit AWS running on your local machine for development.

This guide will walk you through the entire process of setting up a local development environment for LaunchKit AWS. By the end, you'll have a fully functional version of the application running on your machine.

### Prerequisites

Before you begin, please ensure you have the following tools installed and configured on your system:

* **Node.js** (v18.x or later)
* **Yarn**
* **Docker** & **Docker Compose**
* **Git**

***

### Step 1: Clone the Repository

First, clone the LaunchKit AWS repository to your local machine.

```bash theme={null}
git clone https://github.com/LaunchKit-AWS/saas-starter-kit.git
```

### Step 2: Navigate to the Project Folder

Change into the newly created project directory.

```bash theme={null}
cd saas-starter-kit
```

### Step 3: Install Dependencies

Install all the necessary project dependencies using Yarn.

```bash theme={null}
yarn install
```

### Step 4: Set Up Environment Variables

The project uses environment variables to manage secret keys and configuration. You'll need to create a local `.env` file.

1. Duplicate the example file:
   ```bash theme={null}
   cp .env.example .env
   ```

2. **Important:** Open the new `.env` file. For basic local development, you **do not** need to fill in all the variables. The application will run without keys for services like Stripe, transactional emails, or social logins. You can add these later as you explore those features.

### Step 5: Start the Database

LaunchKit uses a Postgres database, which can be easily started using Docker Compose. This command will run a Postgres container in the background.

```bash theme={null}
docker-compose up -d
```

### Step 6: Apply the Database Schema

With the database running, you need to apply the database schema using Prisma.

```bash theme={null}
npx prisma db push
```

### Step 7: Run the Development Server

Finally, start the Next.js development server.

```bash theme={null}
yarn dev
```

***

### You're Up and Running!

Congratulations! Your LaunchKit AWS application should now be running at **[http://localhost:4002](http://localhost:4002)**.

You can open your browser to this address to see the application in action. You can sign up with a new user account using the standard email and password method without any further configuration.

### Next Steps

Now that you have the basic application running, the next step is to configure some of the core features.

<Card title="Next: Configuration" icon="sliders" href="/getting-started/configuration">
  Learn how to add your API keys for services like Stripe and Google/GitHub for
  social logins.
</Card>