KO | EN

GitLite

Minimalist Open Source Repository Search Engine

gitlite — search

#developer-tools #typescript #claude-code #codex #dsh #dsh-plugin #ai-agent #ai-agents #deepseek-harness #agent-skills #macos #cli

Indigo-ELN-v.-2.0

★ 59 Open GitHub ↗

Indigo ELN - Open Source Chemistry Electronic Lab Notebook

// repository documentation

Was this content helpful?

★ 0 (0 ratings)

# Indigo-ELN-v.-2.0

Indigo - The Open-Source Chemistry Electronic Lab Notebook

# Sandbox

We don't have the demo environment at the moment, but we are working to have a publicly accessible environment for the new 3.0 version so you can try it.

# Installation

**NB**: Indigo ELN is currently being severely transformed. Deployment script, application code and documentation may contain errors and inconsistencies.

Please contact the Indigo ELN team in case of any questions.

**NB**: Right now, build script assumes the application is deployed into us-east-1 region (North Virginia) because it uses AWS Public Container Registry which is only available in this region.
However, you can copy images to your own ECR repository and adjust XXXServiceTag parameters to refer to that repository.

## Local Installation
- You must have recent version of Docker installed
- Check our Indigo ELN repository:
```bash
git clone https://github.com/epam/Indigo-ELN-v.-2.0.git
cd Indigo-ELN-v.-2.0
```
- Create directories for persistent data:
```bash
sudo mkdir -p /var/local/indigoeln/{mongo-db,postgres-signature,postgres-crs,bingodb}
```
- If you want to open the application on hostname other than localhost, e.g. if you run the application on remote machine, update CORS_ORIGIN in docker-compose-local.yml with IP address or hostname of that machine:
```yaml
  server:
    ...
    environment:
      ...
      # allow cors for UI
      - CORS_ORIGIN=http://172.27.138.170:9000
      # or
      - CORS_ORIGIN=http://remote-machine:9000
```

- From the root of the repository, run:
```bash
docker compose -f docker-compose-local.yml up
```
It will build all containers and start the application. You can access the application UI at `http://localhost:9000`

## Installation on AWS
- Check our Indigo ELN repository:
```bash
git clone https://github.com/epam/Indigo-ELN-v.-2.0.git
cd Indigo-ELN-v.-2.0
```

### Deploy a CloudFormation script
`indigo_eln_script.yaml`

You can do it via AWS Console or AWS CLI (`aws cloudformation create-stack`) or a helper tool like Rain (https://github.com/aws-cloudformation/rain)

Be sure to review the script adjust parameters before deploy.

Some required parameters:
- KeyPairName: Name of an existing Amazon EC2 key pair to enable SSH or RDP access to the instances
- VPCId: ID of your existing AWS VPC
- HostedZoneId: Existing Route53 Hosted zone ID
- IndigoELNDomainName: Domain name where Indigo ELN will be hosted
- IndigoELNAPIDomainName: Domain name where Indigo ELN API will be hosted
- IndigoELNContentBucketName: S3 bucket where frontend code will be served from (will be created)
- IndigoELNBuildLogsBucketName: S3 bucket where build logs are stored (will be created)
- MongoDBPassword: password for the created instance of MongoDB
- DefaultAdminPassword: password for main application admin user, BCrypt encoded

Also, update image tags for the Docker images used. Typically, you need the latest time tag with given prefix. Latest tags at the time of writing are already included in the CloudFormation script. Alternatively, you can find it here https://gallery.ecr.aws/m5k0g6n7/indigo_eln.

### Validate installation and troubleshooting

- Make sure CloudFormation stack is deployed and all resources created without errors.

- Connect to EC2 instance using specified key pair, make sure all docker containers are running:
```bash
docker ps
```
There should be 8 containers running: mongo-db, postgres-signature, postgres-crs, bingodb, server, signature, crs, indigo

If there are fewer of them, you can find IDs of stopped containers and inspect its logs:
```bash
docker ps --all
docker logs <container_id>
```

- Now you can log into the application using the domain name you specified in the CloudFormation script (default credentials is admin/admin, if you didn't change the password parameter)

Indigo-ELN-v.-2.0

Explore Similar Repositories

Was this content helpful?

Recent Feedback

Download README