43 lines
1.9 KiB
Markdown
43 lines
1.9 KiB
Markdown
# OVDashboard UI
|
|
|
|
|
|
## Quick Start
|
|
|
|
If you only want a working installation, it is highly recommended to use the `docker` image on [`code.yavook.de`](https://code.yavook.de/OEKZident.de/-/packages/container/ovdashboard).
|
|
The image contains both the API and UI.
|
|
Refer to the [main README](../README.md) for an in-depth how-to.
|
|
|
|
|
|
## Setup for development and contribution
|
|
|
|
No need to fiddle around with specific Node.js versions.
|
|
You only need a "general purpose" development setup to get this project up and running for debug and contribution purposes:
|
|
|
|
- [Docker Engine](https://docs.docker.com/engine/install/)
|
|
- [Visual Studio Code](https://code.visualstudio.com/)
|
|
- [Dev Containers](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-containers) (VSCode extension)
|
|
|
|
Once you open this directory in VSCode, you should be prompted to reopen it in a development container.
|
|
If not, hit `Ctrl+Alt+P` and search for "reopen in container".
|
|
|
|
|
|
## Running the UI without the `docker` image
|
|
|
|
> You probably don't need this! Usually the image is good enough!
|
|
|
|
However, if you want to deploy the UI on a cluster or any custom web server, go ahead.
|
|
First, run `yarn build` in this directory - You will probably want to use VSCode with the development container as described above.
|
|
Alternatively, you can copy the `/usr/local/share/ovdashboard_ui/html` directory from the `docker` image:
|
|
|
|
```sh
|
|
id=$(docker create code.yavook.de/oekzident.de/ovdashboard:<IMAGE_TAG>)
|
|
docker cp "${id}:/usr/local/share/ovdashboard_ui/html" "<LOCAL_PATH>"
|
|
docker rm -v "${id}"
|
|
```
|
|
|
|
Then you can deploy the `<LOCAL_PATH>` directory as the webroot using your favourite web server.
|
|
|
|
|
|
## Configuration
|
|
|
|
The OVDashboard UI is created using Vue.js. Even though the default config should fit most applications, you can refer to the [Configuration Reference](https://cli.vuejs.org/config/) for what can be configured additionally.
|