mirror of
https://github.com/freqtrade/frequi.git
synced 2024-11-10 10:21:55 +00:00
113 lines
3.1 KiB
Markdown
113 lines
3.1 KiB
Markdown
# FreqUI
|
|
|
|
[](https://open.vscode.dev/freqtrade/frequi)
|
|
|
|
|
|
Freqtrade UI build with [Vue.js](https://vuejs.org/) and [boostrap-vue](https://bootstrap-vue.org/).
|
|
|
|
## WARNING
|
|
|
|
This project is still in its early stages (consider it alpha), and is not yet stable nor recommended to be used for production usages.
|
|
|
|
## Run this project
|
|
|
|
Using FreqUI, does require [freqtrade](https://github.com/freqtrade/freqtrade) to be setup and running.
|
|
In newer versions (2021.2 and newer), freqUI is builtin to freqtrade, so manual setup of freqUI will no longer be necessary unless you want to modify freqUI.
|
|
Instructions for this end-user setup can be found in the [freqtrade API documentation](https://www.freqtrade.io/en/stable/rest-api/).
|
|
|
|
## Developer project setup
|
|
|
|
It will require [freqtrade](https://github.com/freqtrade/freqtrade) to be running on the same host with the API enabled under (`localhost:8080`). You can either use the webpack proxy (port can be changed in `vue.config.js`) - or connect directly to the API (recommended).
|
|
|
|
You will also have to have CORS for freqtrade configured correctly based on the [freqtrade documentation](https://www.freqtrade.io/en/latest/rest-api/#cors).
|
|
Most likely, the correct entry will be `http://localhost:3000` or `http://127.0.0.1:3000` - but the URL must match the URL you use to access FreqUI.
|
|
Ports can vary, so check the URL you're using.
|
|
|
|
### Project setup
|
|
|
|
```
|
|
yarn install
|
|
```
|
|
|
|
### Compiles and hot-reloads for development
|
|
|
|
```
|
|
yarn serve
|
|
```
|
|
|
|
### Compiles and minifies for production
|
|
|
|
```
|
|
yarn build
|
|
```
|
|
|
|
### Lints and fixes files
|
|
|
|
```
|
|
yarn lint
|
|
```
|
|
|
|
### Build and run docker version
|
|
|
|
```
|
|
docker-compose build
|
|
docker-compose up -d
|
|
|
|
# Access using http://localhost:3000/
|
|
```
|
|
|
|
|
|
### Customize configuration
|
|
|
|
See [Configuration Reference](https://cli.vuejs.org/config/).
|
|
|
|
## Project setup for docker (developing inside dev container) without vscode
|
|
|
|
### Built dev docker image and run container(s) detached
|
|
|
|
```
|
|
cd .devcontainer
|
|
docker-compose up -d
|
|
```
|
|
|
|
### Go inside web-service container and serve
|
|
|
|
```
|
|
docker-compose exec web /bin/bash
|
|
```
|
|
|
|
then
|
|
|
|
```
|
|
yarn serve
|
|
```
|
|
|
|
## Project setup for vscode and docker (developing inside dev container) on Linux
|
|
|
|
The goal is to have a complete dev environment very quickly and isolated.
|
|
|
|
### Install missing tools if needed
|
|
|
|
Follow [getting started](https://code.visualstudio.com/docs/remote/containers#_getting-started) section.
|
|
|
|
### Build your dev container
|
|
|
|
View > Command palette > Enter: Remote-Containers rebuild container
|
|
|
|
### Serve your local server
|
|
|
|
```
|
|
yarn serve
|
|
```
|
|
|
|
You now have useful vscode extensions, git support, your command history of the project.
|
|
|
|
### Fix cypress errors
|
|
|
|
Depending on the system configuration (node version, ...), there can failures when starting cypress.
|
|
This can be mitigated by using the following environment variable.
|
|
|
|
```
|
|
export NODE_OPTIONS=--openssl-legacy-provider
|
|
```
|