Install GoldenGate Studio Free

Discover what you need and how to get started with GoldenGate Studio Free.

What You Need

To use GoldenGate Studio Free, you need the following:

A system running one of the following:
- Docker, or a compatible container runtime such as Podman
- Linux
Internet connectivity to access the container registry
A valid Oracle.com login

From Oracle Container Registry

Follow these instructions to access the GoldenGate Studio Free from Oracle Container Registry (OCR).

You must sign in to your Oracle account and accept the license agreement before you can pull the GoldenGate Studio Free docker image from the Oracle Container Registry.
Obtain an Auth token from the Oracle Container Registry page and use this as your password along with your username.

To access the GoldenGate Studio Free docker image:

Accept the license agreement.
In your Docker client, enter the following command to log in to the Oracle Container Registry:
```
docker login container-registry.oracle.com
```
When prompted, enter your Oracle account username and the Auth token password.
Copy the docker pull command to pull the latest GoldenGate Studio Free image, and run it in your Docker client:
```
docker pull container-registry.oracle.com/goldengate/goldengate-studio-free:latest
```

Start and run the GoldenGate Studio Free docker image

Learn to start and run GoldenGate Studio Free after pulling the docker image from Oracle Container Registry.

To start and run GoldenGate Studio Free:

In your Docker client, you can enter a run command with default settings or enter a run command with parameter values:
- To run GoldenGate Studio Free with default settings:
```
docker run -p 8443:8443 -e STUDIO_ADMIN=studioadmin -e STUDIO_ADMIN_PWD=<password> container-registry.oracle.com/goldengate/goldengate-studio-free:latest
```
  Note: Ensure that you replace <password> with a password of your choice.
  
  A container instantiates with the following default options:
  - An auto generated container name
  - 80 port for HTTP Server
  - 443 port for HTTPS Server
  - studioadmin for the name of the administrative account
  - An auto generated self-signed certificate
- To run GoldenGate Studio Free with modified settings:
```
docker run \
    --name <container name> \
    --hostname <domain name> \
    -p <host port>:8443 \
    -e STUDIO_ADMIN=<admin user name> \
    -e STUDIO_ADMIN_PWD=<admin password> \
    container-registry.oracle.com/goldengate/goldengate-studio-free:latest
```
  Parameter descriptions:
  - --name <container-name>: Name for the container. Auto-generated by default.
  - --hostname <domain name> - The domain name to use for subject name and DNS in the self-signed certificate
  - -p <host-port>:8443: The host port to map the GoldenGate Studio HTTPS server. No mapping by default.
  - -e STUDIO_ADMIN: The name of the administrative account to create. by default.
  - -e STUDIO_ADMIN_PWD: The password of the administrative account.
    Tip
    
    Ensure the password meets the following requirements:
    - At least one lowercase character [a...z]
    - At least one upposercase character [A...Z]
    - At least one digit [0...9]
    - At least one special character [- ! @ % & * . #]
    - The length should be between 8 and 30 characters.
After a few minutes, you should see Server started at: https://<host-address>:8443. GoldenGate Studio Free is now ready for you to use.
Launch a web browser, and go to https://<host-address>:8443.
On the GoldenGate Studio Free login screen, enter the username and password that you passed to the docker run command, and then select Log in.

After you log in successfully, you’re brought to the GoldenGate Studio Free Home page.