frequi_origin/README.md

113 lines
3.1 KiB
Markdown
Raw Normal View History

# FreqUI
[![Open in Visual Studio Code](https://img.shields.io/static/v1?logo=visualstudiocode&label=&message=Open%20in%20Visual%20Studio%20Code&labelColor=2c2c32&color=007acc&logoColor=007acc)](https://open.vscode.dev/freqtrade/frequi)
2020-08-31 15:52:06 +00:00
![FreqUI CI](https://github.com/freqtrade/frequi/workflows/FreqUI%20CI/badge.svg)
2020-05-14 09:11:57 +00:00
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
2020-05-14 09:11:57 +00:00
2022-02-05 19:13:18 +00:00
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).
2022-02-05 19:13:18 +00:00
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.
2021-01-29 09:45:26 +00:00
Ports can vary, so check the URL you're using.
2020-05-14 09:11:57 +00:00
2020-06-04 09:02:46 +00:00
### Project setup
2020-05-18 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
```
2020-06-05 09:22:14 +00:00
yarn install
2020-05-04 04:31:12 +00:00
```
### Compiles and hot-reloads for development
2020-05-18 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
```
2020-06-05 09:22:14 +00:00
yarn serve
2020-05-04 04:31:12 +00:00
```
### Compiles and minifies for production
2020-05-18 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
```
2020-06-05 09:22:14 +00:00
yarn build
2020-05-04 04:31:12 +00:00
```
### Lints and fixes files
2020-05-18 18:49:30 +00:00
2020-05-04 04:31:12 +00:00
```
2020-06-05 09:22:14 +00:00
yarn lint
2020-05-04 04:31:12 +00:00
```
### Build and run docker version
```
docker-compose build
docker-compose up -d
2022-02-05 19:13:18 +00:00
# Access using http://localhost:3000/
```
2020-05-04 04:31:12 +00:00
### Customize configuration
2020-05-04 04:31:12 +00:00
See [Configuration Reference](https://cli.vuejs.org/config/).
2020-06-04 09:02:46 +00:00
## 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
```
2021-01-29 09:45:26 +00:00
### Go inside web-service container and serve
```
docker-compose exec web /bin/bash
```
then
```
yarn serve
```
2021-01-29 09:45:26 +00:00
## Project setup for vscode and docker (developing inside dev container) on Linux
2020-06-04 09:02:46 +00:00
The goal is to have a complete dev environment very quickly and isolated.
2020-06-04 09:02:46 +00:00
### Install missing tools if needed
2021-01-29 09:45:26 +00:00
Follow [getting started](https://code.visualstudio.com/docs/remote/containers#_getting-started) section.
2020-06-04 09:02:46 +00:00
### Build your dev container
View > Command palette > Enter: Remote-Containers rebuild container
### Serve your local server
2020-06-04 09:02:46 +00:00
```
yarn serve
```
2021-01-29 09:45:26 +00:00
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
```