> For the complete documentation index, see [llms.txt](https://codelit.gitbook.io/courselit/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://codelit.gitbook.io/courselit/getting-started/ansible.md).

# Using Ansible \[Deprecated]

## Introduction

You can also install CourseLit on your server using Ansible. Following are the steps.

## Installation Steps

### Step 1. Clone the repository

Fire up your terminal and issue the following commands

```
$ git clone https://github.com/codelit/courselit.git
$ cd courselit
```

### Step 2. Run the installer via [Ansible](https://www.ansible.com/)

{% hint style="danger" %}
**Caution:** Preserve the inputs that you are going to provide to the installer for future maintenance. **If you lose these values, you may lose the access to your data.**
{% endhint %}

#### **1.** With an inventory file (Recommended)

Use this method when you already have the server configured via `/etc/ansible/hosts` file and SSH keys are setup.

```
$ ansible-playbook deployment/install.yml -l HOST -u USER --ask-become-pass -e 'ansible_python_interpreter=/usr/bin/python3'
```

Where **HOST** is the Ansible host (your server) and **USER** is a user on the host which is having [sudo](https://en.wikipedia.org/wiki/Sudo) rights.

#### 2. Without an inventory file

Use this method to install CourseLit on any random server without managing any Ansible inventory and without registering any SSH keys.

```bash
ansible-playbook deployment/install.yml -i your-domain.com, -u USER --ask-become-pass --ask-pass
```

{% hint style="danger" %}
**Important:** Notice the comma after your-domain.com in the above command. It is required for the installer to work.
{% endhint %}

{% hint style="success" %}
The installer script has been tested on Ubuntu 20.04 LTS and Debian 10 Buster.
{% endhint %}

### Step 3. Sign up for an account

You should immediately sign up for an account on your new site before sending any traffic to it, **as the very first user who signs up automatically becomes an administrator.**

Once you have signed up, you can control all aspects of your website by visiting `https://your-domain.com/create` route. For more, visit the administration section of this book.

Congratulations! You now have a fully functioning teaching portal at your disposal. Go figure. 🤩

## Something's Not Clear?

Come chat with us in our [official Discord channel](https://discord.com/invite/GR4bQsN).
