# hpccloud-services

**Repository Path**: mirrors_Kitware/hpccloud-services

## Basic Information

- **Project Name**: hpccloud-services
- **Description**: Docker compose infrastructure for HPCCloud and the required services
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2020-08-09
- **Last Updated**: 2026-03-14

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# HPCCloud Services

## Goal

Streamline a test deployment environment.

### Running it

```
git clone https://github.com/Kitware/hpccloud-services.git
cd hpccloud-services
```

If you have run the system before, you may need to re-pull the stack of images:

```
docker-compose pull
```

And then you can bring the system up with:

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

Once done, make sure ansible is done configuring the various bits by looking at the following log

```
docker logs -f hpccloud-services_ansible_1
```

At that point you should be able to connect to http://localhost:8888 and login as demo/letmein

If you want to stop the services you can run the command

```
docker-compose down
```

### Running w/ GPU accleration

In order to run compute and visualize containers which can utilize the GPU on your system:

```
docker-compose -f docker-compose.yml -f docker-compose-nvidia.yml up -d
```

This will apply the service overrides found in `docker-compose-nvidia.yml`, which make use of the `nvidia` container runtime.

Note: Docker 19.03 requires [additional setup](https://github.com/docker/compose/issues/6691#issuecomment-525245786) to enable the "runtime" keyword in docker-compose. The nvidia runtime is only available on Linux. [Details](https://github.com/Kitware/hpccloud-services/blob/master/dev_workflow.md).

### Development workflow

[Developent workflow](https://github.com/Kitware/hpccloud-services/blob/master/dev_workflow.md) has more complete instructions on troubleshooting and manual testing.