TIP

Check out the Resourcing Guide before getting started with Docker.

Guide

Note: On Windows, the commands will be slightly different but all the steps are the same.

Install Requirements

• Git
  • Docker (with compose)

Clone the GiiS repo

    git clone --depth 1 https://github.com/giis-ai/giis.git
    ```

### Navigate to the compose files

```bash
    cd giis/deployment/docker_compose
    ```

### Launch GiiS

To pull images from Docker Hub and start GiiS:

    ```bash
    docker compose up -d
    ```

    Alternatively, to build images from source:

    ```bash
    docker compose up -d --build --force-recreate
    ```

    ::: warning
      If you've previously launched GiiS with the old `giis-stack` service name,
      you'll need to add `-p giis-stack` to your launch command.

      For example: `docker compose up -p giis-stack -d`.

After the containers come up, the system needs to go through an initialization process after which you can access GiiS at localhost:3000.

Enabling GiiS Craft

To enable GiiS Craft (AI-powered artifact builder for web apps, documents, and slides):

Option 1: Use the installation script (Recommended)

Run the installation script with the --include-craft flag:

cd giis/deployment/docker_compose
./install.sh --include-craft

Then start the services:

cd giis_data/deployment
docker compose up -d

Option 2: Existing deployments

If you've already set up GiiS, you can enable Craft by running:

ENABLE_CRAFT=true IMAGE_TAG=craft-latest docker compose up -d

See the Craft documentation for full details on capabilities and configuration.

:::