# Quick Reference
Oracle TimesTen In-Memory Database Express Edition (XE) is a free edition of Oracle TimesTen In-Memory Database, licensed under the Oracle Free Use Terms and Conditions license. TimesTen XE functions mostly the same as the regular TimesTen product with some restrictions. Details of the restrictions for TimesTen XE are described in the [TimesTen Licensing Guide](https://docs.oracle.com/en/database/other-databases/timesten/22.1/licensing/licensing-information.html). The TimesTen XE Docker image contains:
- An Oracle Linux distribution, including optional packages that are a prerequisite for TimesTen XE release
- Oracle Java (required for ZooKeeper and some other utilities)
- A `timesten` group and `timesten` user
- A TimesTen XE installation that is created from the official TimesTen XE distribution
- A TimesTen XE Classic instance that is based on the TimesTen XE installation
- A directory that contains the TimesTen Kubernetes Operator distribution. This directory is contained within the `operator.zip`file from the TimesTen XE distribution
- A directory that contains the Zookeeper distribution. This directory is contained within the `apache-zookeeper-\*.tar.gz`file from the TimesTen XE distribution
The Kubernetes Operator is not required for basic container functionality but is highly recommended if deploying TimesTen containers in Kubernetes. See [TimesTen Kubernetes Operator User’s Guide](https://docs.oracle.com/en/database/other-databases/timesten/22.1/kubernetes-operator/overview-oracle-timesten-kubernetes-operator1.html#GUID-A62BE41E-7A06-4C67-BC7C-726CDB018904) for more information.
For more information on TimesTen 22.1, see [TimesTen Documentation](https://docs.oracle.com/en/database/other-databases/timesten/index.html).
# Using the TimesTen XE Images
The Oracle TimesTen development team maintains the TimesTen XE Docker images. These images are built specifically for Linux platforms.
## Prerequisites
- A system running Docker, or a compatible container runtime.
- Internet connectivity (needed to access this container registry)
- A valid Oracle.com login (free to create).
## Access the TimesTen XE Docker Image
You must sign in using your Oracle account and accept the license agreement before you can pull the TimesTen Docker image from the Oracle Container Registry. You can find the license agreement on the right side of this page.
1. Accept the license agreement.
2. Generate an Auth Token for the next step. </br>
a. Go to the upper right corner under your login.</br>
b. Select Auth Token. </br>
c. Use Generate Secret Key button to create Auth Token.</br>
d. Copy secret key/Auth Token it generated.</br>
3. On your Docker client, use the `docker login` command to log in to the Oracle Container Registry. When prompted, enter your Oracle account username and the Auth Token from step 2 as password.
`$ docker login container-registry.oracle.com`
`Username: <Oracle account username>`
`Password: <Auth Token>`
3. Use the `docker pull` command to pull the TimesTen images.
`$ docker pull container-registry.oracle.com/timesten/timesten-xe:22.1.1.2.0`
## Start and Connect to a TimesTen XE Classic Instance
1. Use the `docker run` command to create the tt container and start the TimesTen Classic instance.
`$ docker run –-init -d --name tt –-rm container-registry.oracle.com/timesten/timesten-xe:22.1.1.2.0`
2. Use the `docker exec` command to create a shell in the container.
`$ docker exec -it tt /bin/bash`
3. Use the TimesTen `ttDaemonAdmin` utility to start the TimesTen daemon. Then, use the TimesTen `ttStatus` utility to display TimesTen status information.
```
[timesten]$ ttDaemonAdmin -start
[timesten]$ ttStatus
```
You successfully started and connected to a TimesTen XE Classic instance. You are ready to create a TimesTen database. See the [TimesTen Documentation ](https://docs.oracle.com/en/database/other-databases/timesten/index.html)for more information.
**IMPORTANT:** The TimesTen instance contained in the official image resides on the containers internal (transient) storage. The instance, and any databases created by it, are not persistent and will disappear as soon as the container stops. To use persistent databases with containers you need to provide external persistent storage. For a step by step example of how to do this, consult the [Oracle TimesTen In-Memory Database samples](https://github.com/oracle/oracle-timesten-samples) on GitHub.
# Documentation Accessibility
For information about Oracle's commitment to accessibility, visit the Oracle Accessibility Program website at http://www.oracle.com/pls/topic/lookup?ctx=acc&id-docacc.
# Access to Oracle Support
TimesTen XE is not supported by Oracle Support. Questions regarding TimesTen XE can be posted in the [TimesTen Community Forum](https://community.oracle.com/tech/apps-infra/categories/timesten_in-memory_database).