Marvin with CLI¶

Chemaxon public repository
- Acquire credentials
Marvin with npm
Marvin with Docker
- Setup credentials
- Quickstart with docker
  - Alternative ways to pass license to the docker container

Chemaxon public repository¶

For general information on accessing Chemaxon's public repository at https://chemaxon.jfrog.io/, refer to the repository guide.

Acquire credentials¶

To obtain credentials for the Chemaxon public repository, follow the steps in this guide. The generated personal identity token can be reused in the steps below.

Marvin with npm¶

Marvin's frontend is distributed as an npm package, available at the public registry: https://chemaxon.jfrog.io/artifactory/npm/.

Set Up credentials¶

Use the identity token from the previous step as your npm authentication token. Add the following to your .npmrc file:

email = <your email>
always-auth = true
registry=https://chemaxon.jfrog.io/artifactory/api/npm/npm/
//chemaxon.jfrog.io/artifactory/api/npm/npm/:_authToken=<your indentity token>

Alternatively, you can log in using the npm CLI:

1	`npm login --registry=https://chemaxon.jfrog.io/artifactory/api/npm/npm/ --auth-type=web`

For a detailed guide on configuring the npm client with Chemaxon's registry, visit this direct link to jfrog (login required via Chemaxon OKTA), click Set Me Up in the top-right corner, and follow the instructions.

Scoped packages¶

To limit Chemaxon's registry usage to only @chemaxon-scoped packages, use the following in your .npmrc:

@chemaxon:registry=https://chemaxon.jfrog.io/artifactory/api/npm/npm/
//chemaxon.jfrog.io/artifactory/api/npm/npm/:_authToken=<your identity token>
//chemaxon.jfrog.io/artifactory/api/npm/npm/:email=<your email>
//chemaxon.jfrog.io/artifactory/api/npm/npm/:always-auth=true

Install Marvin through NPM¶

Once credentials are configured, install Marvin and example components:

1 2	`npm install @chemaxon/marvin nmp install @chemaxon/marvin-examples`

Framework-specific integration¶

Marvin is a precompiled React component and can be integrated with various frontend frameworks. Examples are available in our public GitHub repository:

Marvin with Docker¶

The marvinws docker image can be found in registry chemaxon.jfrog.io under in the repository
cxn-docker-release/chemaxon/. The image contains the Marvin Web Services and the Marvin frontend as well. It is built on Temurin JDK, with a default user cxnapp, and default entry point
/app/marvinws/run-marvinws.

Setup credentials¶

Use the identity token from the previous step as your Docker credential.

To log in:

1	`docker login chemaxon.jfrog.io`

Use your email and the identity token when prompted.

Alternatively, navigate to this link, click Set Me Up, and follow the instructions.

Quickstart with docker¶

Login to the registry.
See the previous step.

Pull the latest image

1	`docker pull chemaxon.jfrog.io/cxn-docker-release/chemaxon/marvinws:latest`

Run the image

Map the default port 8080 to one of the hosts' ports (e.g. -p 8080:8080)

Map the license file or license settings as an external resource ( for details,
see below).

1	`-v path/to/license-file:/home/cxnapp/.chemaxon/license.cxl`

or

1	`-v path/to/license-key-config:/home/cxnapp/.chemaxon/license-manager.cxl`

Full run command

1	`docker run --name marvin -d -v /home/user/license.cxl:/home/cxnapp/.chemaxon/license.cxl -p 8080:8080 chemaxon.jfrog.io/cxn-docker-release/chemaxon/marvinws`

Verify that the docker container is up and running
1
docker logs marvin
You can access the running editor at http://localhost:8080.

Alternative ways to pass license to the docker container¶

set an environment variable with -e CHEMAXON_LICENSE_SERVER_KEY=<license-key>
pass a JVM parameter -Dchemaxon.license.serve.key=<license-key>
map the Chemaxon home directory (.chemaxon) or the license/configuration file (see above)
use Docker secrets