# Getting Started with Web Console

Web Console의 설정은 환경 변수 파일로 관리됩니다. `systemctl start ovenstudio` 명령어로 시작 시 다음 경로에서 환경 변수를 로드합니다.

```bash
/usr/share/ovenmediaengine/ovenstudio/system.env
```

{% hint style="info" %}
`ovenstudio`는 OvenMediaEngine Enterprise가 제공하는 Web Console을 의미합니다.
{% endhint %}

## `system.env` 구성하기

환경 변수 파일의 기본 구성은 다음과 같습니다.

```bash
OS_SERVER_PORT=8080

LOG_DIR=/var/log/ovenmediaengine/ovenstudio

JAVA_HOME=/usr/share/ovenmediaengine/ovenstudio/jvm/jdk-17.0.10+7-jre
```

{% hint style="info" %}
Host IP 설정을 한 경우 다음 내용이 추가로 포함되어 있습니다.

* `OME_HOST_IP=Your.HOST.IP.Address`
  {% endhint %}

### 환경 변수

<table><thead><tr><th width="239">Env</th><th>Description</th></tr></thead><tbody><tr><td>OS_SERVER_PORT</td><td>Web Console이 구동 될 서비스 포트: <code>8080</code></td></tr><tr><td>LOG_DIR</td><td>Web Console의 로그 저장 경로: <code>/var/log/ovenmediaengine/ovenstudio</code></td></tr><tr><td>JAVA_HOME</td><td>JAVA 설치 경로: <code>/usr/share/ovenmediaengine/ovenstudio/jvm/jdk-17.0.10+7-jre</code></td></tr><tr><td>OME_HOST_IP</td><td>OvenMediaEngine의 Host IP</td></tr></tbody></table>

{% hint style="info" %}
직접 관리하는 다른 버전의 Java를 사용하고 싶은 경우, **`JAVA_HOME`** 경로를 변경한 후 Web Console을 재시작 하십시오.

* <mark style="color:red;">**JAVA 17**</mark> <mark style="color:red;"></mark><mark style="color:red;">버전 이상</mark>
  {% endhint %}

## 관리자 비밀번호

Web Console의 관리자 비밀번호는 파일로 관리됩니다. Web Console 시작 시 `.admin-password` 파일이 없는 경우 자동 생성되며 초기 비밀번호는 `ovenstudio` 입니다.

<pre class="language-sh"><code class="lang-sh"><strong>$ cat /usr/share/ovenmediaengine/ovenstudio/conf/.admin-password
</strong>ovenstudio
$
</code></pre>

### 비밀번호 변경

다음과 같이 .admin-password 파일을 직접 수정하여 비밀번호를 변경 할 수 있습니다. 변경된 비밀번호는 Web Console의 재시작 없이 즉시 적용됩니다.

```sh
$ echo 'new-password' > /usr/share/ovenmediaengine/ovenstudio/conf/.admin-password
$ cat /usr/share/ovenmediaengine/ovenstudio/conf/.admin-password
new-password
$
```

{% hint style="info" %}
[Change Password](/guide/ko-kr/exclusive/web-console/web-console-overview/change-password.md) 와 같이 UI를 통해 비밀번호를 변경 할 수도 있습니다.
{% endhint %}

## 변경 내용 적용

환경 변수가 변경된 경우 Web Console (ovenstudio)을 재시작 해야 해당 내용이 적용되며, 아래와 같은 명령어를 통해 Web Console을 재시작 할 수 있습니다.

```bash
$ sudo systemctl restart ovenstudio
```

## Web Console 접속하기

사용자는 아래와 같은 URL 패턴을 통해 Web Console에 접속할 수 있습니다:

```html
http://<OME_HOST_IP>:<OS_SERVER_PORT>
```

<table><thead><tr><th width="239">Env</th><th>Description</th></tr></thead><tbody><tr><td>OME_HOST_IP</td><td>OvenMediaEngine Enterprise를 실행하는 서버의 IP 주소</td></tr><tr><td>OS_SERVER_PORT</td><td>Web Console이 구동 될 서비스 포트</td></tr></tbody></table>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://ovenmediaengine-enterprise.gitbook.io/guide/ko-kr/exclusive/web-console/getting-started-with-web-console.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.