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

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

1. Accept the license agreement.
2. In your Docker client, enter the following command to log in to the Oracle Container Registry:

   docker login container-registry.oracle.com
   

3. When prompted, enter your Oracle account username and the Auth token password.
4. 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

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

1. 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 Oracle GoldenGate 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.
2. After a few minutes, you should see Server started at: https://<host-address>:8443. GoldenGate Studio Free is now ready for you to use.
3. Launch a web browser, and go to https://<host-address>:8443.
4. On the GoldenGate Studio Free login screen, enter the username and password that you passed to the docker run command, and then click Log in.