frequi_origin/README.md

96 lines
2.2 KiB
Markdown
Raw Normal View History

2020-05-04 04:31:12 +00:00
# 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
2021-01-29 09:45:26 +00:00
This project is still in its early stages (consider it early-alpha), and is not yet stable nor recommended to be used for production usages.
2020-05-14 09:11:57 +00:00
It will require [freqtrade](https://github.com/freqtrade/freqtrade) to be running on the same host with the API enabled under (`localhost:8081`). You can either use the webpack proxy (port can be changed in `vue.config.js`) - or connect directly to the API (recommended).
FOr this, you will also have to have CORS configured correctly [freqtrade documentation](https://www.freqtrade.io/en/latest/rest-api/#cors).
2021-01-29 09:45:26 +00:00
Most likely, the correct entry will be `http://localhost:8080` or `http://127.0.0.1:8080` - but the URL must match the URL you use to access FreqUI.
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 with node install locally
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
# Access using http://localhost:8080/
```
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
2021-01-29 09:45:26 +00:00
The goal is it has 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.