relative links
This commit is contained in:
parent
79ac20636f
commit
db1c9b8edf
@ -262,4 +262,4 @@ Detailed output for all strategies one after the other will be available, so mak
|
|||||||
|
|
||||||
Great, your strategy is profitable. What if the bot can give your the
|
Great, your strategy is profitable. What if the bot can give your the
|
||||||
optimal parameters to use for your strategy?
|
optimal parameters to use for your strategy?
|
||||||
Your next step is to learn [how to find optimal parameters with Hyperopt](https://github.com/freqtrade/freqtrade/blob/develop/docs/hyperopt.md)
|
Your next step is to learn [how to find optimal parameters with Hyperopt](/hyperopt)
|
||||||
|
@ -247,4 +247,4 @@ We also got a *strategy-sharing* channel in our [Slack community](https://join.s
|
|||||||
## Next step
|
## Next step
|
||||||
|
|
||||||
Now you have a perfect strategy you probably want to backtest it.
|
Now you have a perfect strategy you probably want to backtest it.
|
||||||
Your next step is to learn [How to use the Backtesting](https://github.com/freqtrade/freqtrade/blob/develop/docs/backtesting.md).
|
Your next step is to learn [How to use the Backtesting](/backtesting).
|
||||||
|
@ -89,7 +89,7 @@ This is very simple. Copy paste your strategy file into the folder
|
|||||||
### How to use **--dynamic-whitelist**?
|
### How to use **--dynamic-whitelist**?
|
||||||
|
|
||||||
!!! danger "DEPRECATED"
|
!!! danger "DEPRECATED"
|
||||||
Dynamic-whitelist is deprecated. Please move your configurations to the configuration as outlined [here](docs/configuration.md#Dynamic-Pairlists)
|
Dynamic-whitelist is deprecated. Please move your configurations to the configuration as outlined [here](/configuration/#dynamic-pairlists)
|
||||||
|
|
||||||
Per default `--dynamic-whitelist` will retrieve the 20 currencies based
|
Per default `--dynamic-whitelist` will retrieve the 20 currencies based
|
||||||
on BaseVolume. This value can be changed when you run the script.
|
on BaseVolume. This value can be changed when you run the script.
|
||||||
|
@ -344,4 +344,4 @@ Please ensure that 'NameOfStrategy' is identical to the strategy name!
|
|||||||
|
|
||||||
## Next step
|
## Next step
|
||||||
|
|
||||||
Now you have configured your config.json, the next step is to [start your bot](https://github.com/freqtrade/freqtrade/blob/develop/docs/bot-usage.md).
|
Now you have configured your config.json, the next step is to [start your bot](/bot-usage).
|
||||||
|
@ -242,4 +242,4 @@ Dry/live runs will **NOT** use position stacking - therefore it does make sense
|
|||||||
## Next Step
|
## Next Step
|
||||||
|
|
||||||
Now you have a perfect bot and want to control it from Telegram. Your
|
Now you have a perfect bot and want to control it from Telegram. Your
|
||||||
next step is to learn the [Telegram usage](https://github.com/freqtrade/freqtrade/blob/develop/docs/telegram-usage.md).
|
next step is to learn the [Telegram usage](/telegram-usage).
|
||||||
|
@ -64,4 +64,4 @@ For any questions not covered by the documentation or for further information ab
|
|||||||
Click [here](https://join.slack.com/t/highfrequencybot/shared_invite/enQtMjQ5NTM0OTYzMzY3LWMxYzE3M2MxNDdjMGM3ZTYwNzFjMGIwZGRjNTc3ZGU3MGE3NzdmZGMwNmU3NDM5ZTNmM2Y3NjRiNzk4NmM4OGE) to join Slack channel.
|
Click [here](https://join.slack.com/t/highfrequencybot/shared_invite/enQtMjQ5NTM0OTYzMzY3LWMxYzE3M2MxNDdjMGM3ZTYwNzFjMGIwZGRjNTc3ZGU3MGE3NzdmZGMwNmU3NDM5ZTNmM2Y3NjRiNzk4NmM4OGE) to join Slack channel.
|
||||||
|
|
||||||
## Ready to try?
|
## Ready to try?
|
||||||
Begin by reading our installation guide [here](pre-requisite).
|
Begin by reading our installation guide [here](/installation).
|
@ -1,69 +1,25 @@
|
|||||||
# Installation
|
# Installation
|
||||||
|
|
||||||
This page explains how to prepare your environment for running the bot.
|
This page explains how to prepare your environment for running the bot.
|
||||||
|
|
||||||
## Pre-requisite
|
To understand how to set up the bot please read the [Bot Configuration](https://github.com/freqtrade/freqtrade/blob/develop/docs/configuration.md) page.
|
||||||
Before running your bot in production you will need to setup few
|
|
||||||
external API. In production mode, the bot required valid Bittrex API
|
|
||||||
credentials and a Telegram bot (optional but recommended).
|
|
||||||
|
|
||||||
- [Setup your exchange account](#setup-your-exchange-account)
|
## Table of Contents
|
||||||
- [Backtesting commands](#setup-your-telegram-bot)
|
|
||||||
|
|
||||||
### Setup your exchange account
|
* [Table of Contents](#table-of-contents)
|
||||||
*To be completed, please feel free to complete this section.*
|
* [Easy Installation - Linux Script](#easy-installation---linux-script)
|
||||||
|
* [Automatic Installation - Docker](#automatic-installation---docker)
|
||||||
|
* [Custom Linux MacOS Installation](#custom-installation)
|
||||||
|
- [Requirements](#requirements)
|
||||||
|
- [Linux - Ubuntu 16.04](#linux---ubuntu-1604)
|
||||||
|
- [MacOS](#macos)
|
||||||
|
- [Setup Config and virtual env](#setup-config-and-virtual-env)
|
||||||
|
* [Windows](#windows)
|
||||||
|
|
||||||
### Setup your Telegram bot
|
<!-- /TOC -->
|
||||||
The only things you need is a working Telegram bot and its API token.
|
|
||||||
Below we explain how to create your Telegram Bot, and how to get your
|
|
||||||
Telegram user id.
|
|
||||||
|
|
||||||
### 1. Create your Telegram bot
|
------
|
||||||
|
|
||||||
**1.1. Start a chat with https://telegram.me/BotFather**
|
|
||||||
|
|
||||||
**1.2. Send the message `/newbot`. ** *BotFather response:*
|
|
||||||
```
|
|
||||||
Alright, a new bot. How are we going to call it? Please choose a name for your bot.
|
|
||||||
```
|
|
||||||
|
|
||||||
**1.3. Choose the public name of your bot (e.x. `Freqtrade bot`)**
|
|
||||||
*BotFather response:*
|
|
||||||
```
|
|
||||||
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.
|
|
||||||
```
|
|
||||||
**1.4. Choose the name id of your bot (e.x "`My_own_freqtrade_bot`")**
|
|
||||||
|
|
||||||
**1.5. Father bot will return you the token (API key)**<br/>
|
|
||||||
Copy it and keep it you will use it for the config parameter `token`.
|
|
||||||
*BotFather response:*
|
|
||||||
```hl_lines="4"
|
|
||||||
Done! Congratulations on your new bot. You will find it at t.me/My_own_freqtrade_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.
|
|
||||||
|
|
||||||
Use this token to access the HTTP API:
|
|
||||||
521095879:AAEcEZEL7ADJ56FtG_qD0bQJSKETbXCBCi0
|
|
||||||
|
|
||||||
For a description of the Bot API, see this page: https://core.telegram.org/bots/api
|
|
||||||
```
|
|
||||||
**1.6. Don't forget to start the conversation with your bot, by clicking /START button**
|
|
||||||
|
|
||||||
### 2. Get your user id
|
|
||||||
**2.1. Talk to https://telegram.me/userinfobot**
|
|
||||||
|
|
||||||
**2.2. Get your "Id", you will use it for the config parameter
|
|
||||||
`chat_id`.**
|
|
||||||
<hr/>
|
|
||||||
## Quick start
|
|
||||||
Freqtrade provides a Linux/MacOS script to install all dependencies and help you to configure the bot.
|
|
||||||
|
|
||||||
```bash
|
|
||||||
git clone git@github.com:freqtrade/freqtrade.git
|
|
||||||
cd freqtrade
|
|
||||||
git checkout develop
|
|
||||||
./setup.sh --install
|
|
||||||
```
|
|
||||||
!!! Note
|
|
||||||
Windows installation is explained [here](/#windows).
|
|
||||||
<hr/>
|
|
||||||
## Easy Installation - Linux Script
|
## Easy Installation - Linux Script
|
||||||
|
|
||||||
If you are on Debian, Ubuntu or MacOS a freqtrade provides a script to Install, Update, Configure, and Reset your bot.
|
If you are on Debian, Ubuntu or MacOS a freqtrade provides a script to Install, Update, Configure, and Reset your bot.
|
||||||
@ -77,7 +33,7 @@ usage:
|
|||||||
-c,--config Easy config generator (Will override your existing file).
|
-c,--config Easy config generator (Will override your existing file).
|
||||||
```
|
```
|
||||||
|
|
||||||
** --install **
|
### --install
|
||||||
|
|
||||||
This script will install everything you need to run the bot:
|
This script will install everything you need to run the bot:
|
||||||
|
|
||||||
@ -87,15 +43,15 @@ This script will install everything you need to run the bot:
|
|||||||
|
|
||||||
This script is a combination of `install script` `--reset`, `--config`
|
This script is a combination of `install script` `--reset`, `--config`
|
||||||
|
|
||||||
** --update **
|
### --update
|
||||||
|
|
||||||
Update parameter will pull the last version of your current branch and update your virtualenv.
|
Update parameter will pull the last version of your current branch and update your virtualenv.
|
||||||
|
|
||||||
** --reset **
|
### --reset
|
||||||
|
|
||||||
Reset parameter will hard reset your branch (only if you are on `master` or `develop`) and recreate your virtualenv.
|
Reset parameter will hard reset your branch (only if you are on `master` or `develop`) and recreate your virtualenv.
|
||||||
|
|
||||||
** --config **
|
### --config
|
||||||
|
|
||||||
Config parameter is a `config.json` configurator. This script will ask you questions to setup your bot and create your `config.json`.
|
Config parameter is a `config.json` configurator. This script will ask you questions to setup your bot and create your `config.json`.
|
||||||
|
|
||||||
@ -113,33 +69,33 @@ Once you have Docker installed, simply create the config file (e.g. `config.json
|
|||||||
|
|
||||||
### 1. Prepare the Bot
|
### 1. Prepare the Bot
|
||||||
|
|
||||||
**1.1. Clone the git repository**
|
#### 1.1. Clone the git repository
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/freqtrade/freqtrade.git
|
git clone https://github.com/freqtrade/freqtrade.git
|
||||||
```
|
```
|
||||||
|
|
||||||
**1.2. (Optional) Checkout the develop branch**
|
#### 1.2. (Optional) Checkout the develop branch
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git checkout develop
|
git checkout develop
|
||||||
```
|
```
|
||||||
|
|
||||||
**1.3. Go into the new directory**
|
#### 1.3. Go into the new directory
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd freqtrade
|
cd freqtrade
|
||||||
```
|
```
|
||||||
|
|
||||||
**1.4. Copy `config.json.example` to `config.json`**
|
#### 1.4. Copy `config.json.example` to `config.json`
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cp -n config.json.example config.json
|
cp -n config.json.example config.json
|
||||||
```
|
```
|
||||||
|
|
||||||
> To edit the config please refer to the [Bot Configuration](/configuration.md) page.
|
> To edit the config please refer to the [Bot Configuration](https://github.com/freqtrade/freqtrade/blob/develop/docs/configuration.md) page.
|
||||||
|
|
||||||
**1.5. Create your database file *(optional - the bot will create it if it is missing)**
|
#### 1.5. Create your database file *(optional - the bot will create it if it is missing)*
|
||||||
|
|
||||||
Production
|
Production
|
||||||
|
|
||||||
@ -159,7 +115,7 @@ Either use the prebuilt image from docker hub - or build the image yourself if y
|
|||||||
|
|
||||||
Branches / tags available can be checked out on [Dockerhub](https://hub.docker.com/r/freqtradeorg/freqtrade/tags/).
|
Branches / tags available can be checked out on [Dockerhub](https://hub.docker.com/r/freqtradeorg/freqtrade/tags/).
|
||||||
|
|
||||||
**2.1. Download the docker image**
|
#### 2.1. Download the docker image
|
||||||
|
|
||||||
Pull the image from docker hub and (optionally) change the name of the image
|
Pull the image from docker hub and (optionally) change the name of the image
|
||||||
|
|
||||||
@ -171,7 +127,7 @@ docker tag freqtradeorg/freqtrade:develop freqtrade
|
|||||||
|
|
||||||
To update the image, simply run the above commands again and restart your running container.
|
To update the image, simply run the above commands again and restart your running container.
|
||||||
|
|
||||||
**2.2. Build the Docker image**
|
#### 2.2. Build the Docker image
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd freqtrade
|
cd freqtrade
|
||||||
@ -208,7 +164,7 @@ There is known issue in OSX Docker versions after 17.09.1, whereby /etc/localtim
|
|||||||
docker run --rm -e TZ=`ls -la /etc/localtime | cut -d/ -f8-9` -v `pwd`/config.json:/freqtrade/config.json -it freqtrade
|
docker run --rm -e TZ=`ls -la /etc/localtime | cut -d/ -f8-9` -v `pwd`/config.json:/freqtrade/config.json -it freqtrade
|
||||||
```
|
```
|
||||||
|
|
||||||
More information on this docker issue and work-around can be read [here](https://github.com/docker/for-mac/issues/2396).
|
More information on this docker issue and work-around can be read [here](https://github.com/docker/for-mac/issues/2396)
|
||||||
|
|
||||||
In this example, the database will be created inside the docker instance and will be lost when you will refresh your image.
|
In this example, the database will be created inside the docker instance and will be lost when you will refresh your image.
|
||||||
|
|
||||||
@ -216,7 +172,7 @@ In this example, the database will be created inside the docker instance and wil
|
|||||||
|
|
||||||
To run a restartable instance in the background (feel free to place your configuration and database files wherever it feels comfortable on your filesystem).
|
To run a restartable instance in the background (feel free to place your configuration and database files wherever it feels comfortable on your filesystem).
|
||||||
|
|
||||||
**5.1. Move your config file and database**
|
#### 5.1. Move your config file and database
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mkdir ~/.freqtrade
|
mkdir ~/.freqtrade
|
||||||
@ -224,7 +180,7 @@ mv config.json ~/.freqtrade
|
|||||||
mv tradesv3.sqlite ~/.freqtrade
|
mv tradesv3.sqlite ~/.freqtrade
|
||||||
```
|
```
|
||||||
|
|
||||||
**5.2. Run the docker image**
|
#### 5.2. Run the docker image
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker run -d \
|
docker run -d \
|
||||||
@ -235,9 +191,8 @@ docker run -d \
|
|||||||
freqtrade --db-url sqlite:///tradesv3.sqlite
|
freqtrade --db-url sqlite:///tradesv3.sqlite
|
||||||
```
|
```
|
||||||
|
|
||||||
!!! Note
|
*Note*: db-url defaults to `sqlite:///tradesv3.sqlite` but it defaults to `sqlite://` if `dry_run=True` is being used.
|
||||||
db-url defaults to `sqlite:///tradesv3.sqlite` but it defaults to `sqlite://` if `dry_run=True` is being used.
|
To override this behaviour use a custom db-url value: i.e.: `--db-url sqlite:///tradesv3.dryrun.sqlite`
|
||||||
To override this behaviour use a custom db-url value: i.e.: `--db-url sqlite:///tradesv3.dryrun.sqlite`
|
|
||||||
|
|
||||||
### 6. Monitor your Docker instance
|
### 6. Monitor your Docker instance
|
||||||
|
|
||||||
@ -253,15 +208,14 @@ docker start freqtrade
|
|||||||
|
|
||||||
For more information on how to operate Docker, please refer to the [official Docker documentation](https://docs.docker.com/).
|
For more information on how to operate Docker, please refer to the [official Docker documentation](https://docs.docker.com/).
|
||||||
|
|
||||||
!!! Note
|
*Note*: You do not need to rebuild the image for configuration changes, it will suffice to edit `config.json` and restart the container.
|
||||||
You do not need to rebuild the image for configuration changes, it will suffice to edit `config.json` and restart the container.
|
|
||||||
|
|
||||||
### 7. Backtest with docker
|
### 7. Backtest with docker
|
||||||
|
|
||||||
The following assumes that the above steps (1-4) have been completed successfully.
|
The following assumes that the above steps (1-4) have been completed successfully.
|
||||||
Also, backtest-data should be available at `~/.freqtrade/user_data/`.
|
Also, backtest-data should be available at `~/.freqtrade/user_data/`.
|
||||||
|
|
||||||
```bash
|
``` bash
|
||||||
docker run -d \
|
docker run -d \
|
||||||
--name freqtrade \
|
--name freqtrade \
|
||||||
-v /etc/localtime:/etc/localtime:ro \
|
-v /etc/localtime:/etc/localtime:ro \
|
||||||
@ -273,15 +227,14 @@ docker run -d \
|
|||||||
|
|
||||||
Head over to the [Backtesting Documentation](https://github.com/freqtrade/freqtrade/blob/develop/docs/backtesting.md) for more details.
|
Head over to the [Backtesting Documentation](https://github.com/freqtrade/freqtrade/blob/develop/docs/backtesting.md) for more details.
|
||||||
|
|
||||||
!!! Note
|
*Note*: Additional parameters can be appended after the image name (`freqtrade` in the above example).
|
||||||
Additional parameters can be appended after the image name (`freqtrade` in the above example).
|
|
||||||
|
|
||||||
------
|
------
|
||||||
|
|
||||||
## Custom Installation
|
## Custom Installation
|
||||||
|
|
||||||
We've included/collected install instructions for Ubuntu 16.04, MacOS, and Windows. These are guidelines and your success may vary with other distros.
|
We've included/collected install instructions for Ubuntu 16.04, MacOS, and Windows. These are guidelines and your success may vary with other distros.
|
||||||
OS Specific steps are listed first, the [Common](#common) section below is necessary for all systems.
|
OS Specific steps are listed first, the [common](#common) section below is necessary for all systems.
|
||||||
|
|
||||||
### Requirements
|
### Requirements
|
||||||
|
|
||||||
@ -333,7 +286,7 @@ python3 -m pip install -e .
|
|||||||
brew install python3 git wget
|
brew install python3 git wget
|
||||||
```
|
```
|
||||||
|
|
||||||
### Common
|
### common
|
||||||
|
|
||||||
#### 1. Install TA-Lib
|
#### 1. Install TA-Lib
|
||||||
|
|
||||||
@ -351,13 +304,11 @@ cd ..
|
|||||||
rm -rf ./ta-lib*
|
rm -rf ./ta-lib*
|
||||||
```
|
```
|
||||||
|
|
||||||
!!! Note
|
*Note*: An already downloaded version of ta-lib is included in the repository, as the sourceforge.net source seems to have problems frequently.
|
||||||
An already downloaded version of ta-lib is included in the repository, as the sourceforge.net source seems to have problems frequently.
|
|
||||||
|
|
||||||
#### 2. Setup your Python virtual environment (virtualenv)
|
#### 2. Setup your Python virtual environment (virtualenv)
|
||||||
|
|
||||||
!!! Note
|
*Note*: This step is optional but strongly recommended to keep your system organized
|
||||||
This step is optional but strongly recommended to keep your system organized
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m venv .env
|
python3 -m venv .env
|
@ -1,25 +1,69 @@
|
|||||||
# Installation
|
# Installation
|
||||||
|
|
||||||
This page explains how to prepare your environment for running the bot.
|
This page explains how to prepare your environment for running the bot.
|
||||||
|
|
||||||
To understand how to set up the bot please read the [Bot Configuration](https://github.com/freqtrade/freqtrade/blob/develop/docs/configuration.md) page.
|
## Prerequisite
|
||||||
|
Before running your bot in production you will need to setup few
|
||||||
|
external API. In production mode, the bot required valid Bittrex API
|
||||||
|
credentials and a Telegram bot (optional but recommended).
|
||||||
|
|
||||||
## Table of Contents
|
- [Setup your exchange account](#setup-your-exchange-account)
|
||||||
|
- [Backtesting commands](#setup-your-telegram-bot)
|
||||||
|
|
||||||
* [Table of Contents](#table-of-contents)
|
### Setup your exchange account
|
||||||
* [Easy Installation - Linux Script](#easy-installation---linux-script)
|
*To be completed, please feel free to complete this section.*
|
||||||
* [Automatic Installation - Docker](#automatic-installation---docker)
|
|
||||||
* [Custom Linux MacOS Installation](#custom-installation)
|
|
||||||
- [Requirements](#requirements)
|
|
||||||
- [Linux - Ubuntu 16.04](#linux---ubuntu-1604)
|
|
||||||
- [MacOS](#macos)
|
|
||||||
- [Setup Config and virtual env](#setup-config-and-virtual-env)
|
|
||||||
* [Windows](#windows)
|
|
||||||
|
|
||||||
<!-- /TOC -->
|
### Setup your Telegram bot
|
||||||
|
The only things you need is a working Telegram bot and its API token.
|
||||||
|
Below we explain how to create your Telegram Bot, and how to get your
|
||||||
|
Telegram user id.
|
||||||
|
|
||||||
------
|
### 1. Create your Telegram bot
|
||||||
|
|
||||||
|
**1.1. Start a chat with https://telegram.me/BotFather**
|
||||||
|
|
||||||
|
**1.2. Send the message `/newbot`. ** *BotFather response:*
|
||||||
|
```
|
||||||
|
Alright, a new bot. How are we going to call it? Please choose a name for your bot.
|
||||||
|
```
|
||||||
|
|
||||||
|
**1.3. Choose the public name of your bot (e.x. `Freqtrade bot`)**
|
||||||
|
*BotFather response:*
|
||||||
|
```
|
||||||
|
Good. Now let's choose a username for your bot. It must end in `bot`. Like this, for example: TetrisBot or tetris_bot.
|
||||||
|
```
|
||||||
|
**1.4. Choose the name id of your bot (e.x "`My_own_freqtrade_bot`")**
|
||||||
|
|
||||||
|
**1.5. Father bot will return you the token (API key)**<br/>
|
||||||
|
Copy it and keep it you will use it for the config parameter `token`.
|
||||||
|
*BotFather response:*
|
||||||
|
```hl_lines="4"
|
||||||
|
Done! Congratulations on your new bot. You will find it at t.me/My_own_freqtrade_bot. You can now add a description, about section and profile picture for your bot, see /help for a list of commands. By the way, when you've finished creating your cool bot, ping our Bot Support if you want a better username for it. Just make sure the bot is fully operational before you do this.
|
||||||
|
|
||||||
|
Use this token to access the HTTP API:
|
||||||
|
521095879:AAEcEZEL7ADJ56FtG_qD0bQJSKETbXCBCi0
|
||||||
|
|
||||||
|
For a description of the Bot API, see this page: https://core.telegram.org/bots/api
|
||||||
|
```
|
||||||
|
**1.6. Don't forget to start the conversation with your bot, by clicking /START button**
|
||||||
|
|
||||||
|
### 2. Get your user id
|
||||||
|
**2.1. Talk to https://telegram.me/userinfobot**
|
||||||
|
|
||||||
|
**2.2. Get your "Id", you will use it for the config parameter
|
||||||
|
`chat_id`.**
|
||||||
|
<hr/>
|
||||||
|
## Quick start
|
||||||
|
Freqtrade provides a Linux/MacOS script to install all dependencies and help you to configure the bot.
|
||||||
|
|
||||||
|
```bash
|
||||||
|
git clone git@github.com:freqtrade/freqtrade.git
|
||||||
|
cd freqtrade
|
||||||
|
git checkout develop
|
||||||
|
./setup.sh --install
|
||||||
|
```
|
||||||
|
!!! Note
|
||||||
|
Windows installation is explained [here](/#windows).
|
||||||
|
<hr/>
|
||||||
## Easy Installation - Linux Script
|
## Easy Installation - Linux Script
|
||||||
|
|
||||||
If you are on Debian, Ubuntu or MacOS a freqtrade provides a script to Install, Update, Configure, and Reset your bot.
|
If you are on Debian, Ubuntu or MacOS a freqtrade provides a script to Install, Update, Configure, and Reset your bot.
|
||||||
@ -33,7 +77,7 @@ usage:
|
|||||||
-c,--config Easy config generator (Will override your existing file).
|
-c,--config Easy config generator (Will override your existing file).
|
||||||
```
|
```
|
||||||
|
|
||||||
### --install
|
** --install **
|
||||||
|
|
||||||
This script will install everything you need to run the bot:
|
This script will install everything you need to run the bot:
|
||||||
|
|
||||||
@ -43,15 +87,15 @@ This script will install everything you need to run the bot:
|
|||||||
|
|
||||||
This script is a combination of `install script` `--reset`, `--config`
|
This script is a combination of `install script` `--reset`, `--config`
|
||||||
|
|
||||||
### --update
|
** --update **
|
||||||
|
|
||||||
Update parameter will pull the last version of your current branch and update your virtualenv.
|
Update parameter will pull the last version of your current branch and update your virtualenv.
|
||||||
|
|
||||||
### --reset
|
** --reset **
|
||||||
|
|
||||||
Reset parameter will hard reset your branch (only if you are on `master` or `develop`) and recreate your virtualenv.
|
Reset parameter will hard reset your branch (only if you are on `master` or `develop`) and recreate your virtualenv.
|
||||||
|
|
||||||
### --config
|
** --config **
|
||||||
|
|
||||||
Config parameter is a `config.json` configurator. This script will ask you questions to setup your bot and create your `config.json`.
|
Config parameter is a `config.json` configurator. This script will ask you questions to setup your bot and create your `config.json`.
|
||||||
|
|
||||||
@ -69,33 +113,33 @@ Once you have Docker installed, simply create the config file (e.g. `config.json
|
|||||||
|
|
||||||
### 1. Prepare the Bot
|
### 1. Prepare the Bot
|
||||||
|
|
||||||
#### 1.1. Clone the git repository
|
**1.1. Clone the git repository**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git clone https://github.com/freqtrade/freqtrade.git
|
git clone https://github.com/freqtrade/freqtrade.git
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 1.2. (Optional) Checkout the develop branch
|
**1.2. (Optional) Checkout the develop branch**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
git checkout develop
|
git checkout develop
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 1.3. Go into the new directory
|
**1.3. Go into the new directory**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd freqtrade
|
cd freqtrade
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 1.4. Copy `config.json.example` to `config.json`
|
**1.4. Copy `config.json.example` to `config.json`**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cp -n config.json.example config.json
|
cp -n config.json.example config.json
|
||||||
```
|
```
|
||||||
|
|
||||||
> To edit the config please refer to the [Bot Configuration](https://github.com/freqtrade/freqtrade/blob/develop/docs/configuration.md) page.
|
> To edit the config please refer to the [Bot Configuration](/configuration.md) page.
|
||||||
|
|
||||||
#### 1.5. Create your database file *(optional - the bot will create it if it is missing)*
|
**1.5. Create your database file *(optional - the bot will create it if it is missing)**
|
||||||
|
|
||||||
Production
|
Production
|
||||||
|
|
||||||
@ -115,7 +159,7 @@ Either use the prebuilt image from docker hub - or build the image yourself if y
|
|||||||
|
|
||||||
Branches / tags available can be checked out on [Dockerhub](https://hub.docker.com/r/freqtradeorg/freqtrade/tags/).
|
Branches / tags available can be checked out on [Dockerhub](https://hub.docker.com/r/freqtradeorg/freqtrade/tags/).
|
||||||
|
|
||||||
#### 2.1. Download the docker image
|
**2.1. Download the docker image**
|
||||||
|
|
||||||
Pull the image from docker hub and (optionally) change the name of the image
|
Pull the image from docker hub and (optionally) change the name of the image
|
||||||
|
|
||||||
@ -127,7 +171,7 @@ docker tag freqtradeorg/freqtrade:develop freqtrade
|
|||||||
|
|
||||||
To update the image, simply run the above commands again and restart your running container.
|
To update the image, simply run the above commands again and restart your running container.
|
||||||
|
|
||||||
#### 2.2. Build the Docker image
|
**2.2. Build the Docker image**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
cd freqtrade
|
cd freqtrade
|
||||||
@ -164,7 +208,7 @@ There is known issue in OSX Docker versions after 17.09.1, whereby /etc/localtim
|
|||||||
docker run --rm -e TZ=`ls -la /etc/localtime | cut -d/ -f8-9` -v `pwd`/config.json:/freqtrade/config.json -it freqtrade
|
docker run --rm -e TZ=`ls -la /etc/localtime | cut -d/ -f8-9` -v `pwd`/config.json:/freqtrade/config.json -it freqtrade
|
||||||
```
|
```
|
||||||
|
|
||||||
More information on this docker issue and work-around can be read [here](https://github.com/docker/for-mac/issues/2396)
|
More information on this docker issue and work-around can be read [here](https://github.com/docker/for-mac/issues/2396).
|
||||||
|
|
||||||
In this example, the database will be created inside the docker instance and will be lost when you will refresh your image.
|
In this example, the database will be created inside the docker instance and will be lost when you will refresh your image.
|
||||||
|
|
||||||
@ -172,7 +216,7 @@ In this example, the database will be created inside the docker instance and wil
|
|||||||
|
|
||||||
To run a restartable instance in the background (feel free to place your configuration and database files wherever it feels comfortable on your filesystem).
|
To run a restartable instance in the background (feel free to place your configuration and database files wherever it feels comfortable on your filesystem).
|
||||||
|
|
||||||
#### 5.1. Move your config file and database
|
**5.1. Move your config file and database**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
mkdir ~/.freqtrade
|
mkdir ~/.freqtrade
|
||||||
@ -180,7 +224,7 @@ mv config.json ~/.freqtrade
|
|||||||
mv tradesv3.sqlite ~/.freqtrade
|
mv tradesv3.sqlite ~/.freqtrade
|
||||||
```
|
```
|
||||||
|
|
||||||
#### 5.2. Run the docker image
|
**5.2. Run the docker image**
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
docker run -d \
|
docker run -d \
|
||||||
@ -191,8 +235,9 @@ docker run -d \
|
|||||||
freqtrade --db-url sqlite:///tradesv3.sqlite
|
freqtrade --db-url sqlite:///tradesv3.sqlite
|
||||||
```
|
```
|
||||||
|
|
||||||
*Note*: db-url defaults to `sqlite:///tradesv3.sqlite` but it defaults to `sqlite://` if `dry_run=True` is being used.
|
!!! Note
|
||||||
To override this behaviour use a custom db-url value: i.e.: `--db-url sqlite:///tradesv3.dryrun.sqlite`
|
db-url defaults to `sqlite:///tradesv3.sqlite` but it defaults to `sqlite://` if `dry_run=True` is being used.
|
||||||
|
To override this behaviour use a custom db-url value: i.e.: `--db-url sqlite:///tradesv3.dryrun.sqlite`
|
||||||
|
|
||||||
### 6. Monitor your Docker instance
|
### 6. Monitor your Docker instance
|
||||||
|
|
||||||
@ -208,14 +253,15 @@ docker start freqtrade
|
|||||||
|
|
||||||
For more information on how to operate Docker, please refer to the [official Docker documentation](https://docs.docker.com/).
|
For more information on how to operate Docker, please refer to the [official Docker documentation](https://docs.docker.com/).
|
||||||
|
|
||||||
*Note*: You do not need to rebuild the image for configuration changes, it will suffice to edit `config.json` and restart the container.
|
!!! Note
|
||||||
|
You do not need to rebuild the image for configuration changes, it will suffice to edit `config.json` and restart the container.
|
||||||
|
|
||||||
### 7. Backtest with docker
|
### 7. Backtest with docker
|
||||||
|
|
||||||
The following assumes that the above steps (1-4) have been completed successfully.
|
The following assumes that the above steps (1-4) have been completed successfully.
|
||||||
Also, backtest-data should be available at `~/.freqtrade/user_data/`.
|
Also, backtest-data should be available at `~/.freqtrade/user_data/`.
|
||||||
|
|
||||||
``` bash
|
```bash
|
||||||
docker run -d \
|
docker run -d \
|
||||||
--name freqtrade \
|
--name freqtrade \
|
||||||
-v /etc/localtime:/etc/localtime:ro \
|
-v /etc/localtime:/etc/localtime:ro \
|
||||||
@ -227,14 +273,15 @@ docker run -d \
|
|||||||
|
|
||||||
Head over to the [Backtesting Documentation](https://github.com/freqtrade/freqtrade/blob/develop/docs/backtesting.md) for more details.
|
Head over to the [Backtesting Documentation](https://github.com/freqtrade/freqtrade/blob/develop/docs/backtesting.md) for more details.
|
||||||
|
|
||||||
*Note*: Additional parameters can be appended after the image name (`freqtrade` in the above example).
|
!!! Note
|
||||||
|
Additional parameters can be appended after the image name (`freqtrade` in the above example).
|
||||||
|
|
||||||
------
|
------
|
||||||
|
|
||||||
## Custom Installation
|
## Custom Installation
|
||||||
|
|
||||||
We've included/collected install instructions for Ubuntu 16.04, MacOS, and Windows. These are guidelines and your success may vary with other distros.
|
We've included/collected install instructions for Ubuntu 16.04, MacOS, and Windows. These are guidelines and your success may vary with other distros.
|
||||||
OS Specific steps are listed first, the [common](#common) section below is necessary for all systems.
|
OS Specific steps are listed first, the [Common](#common) section below is necessary for all systems.
|
||||||
|
|
||||||
### Requirements
|
### Requirements
|
||||||
|
|
||||||
@ -286,7 +333,7 @@ python3 -m pip install -e .
|
|||||||
brew install python3 git wget
|
brew install python3 git wget
|
||||||
```
|
```
|
||||||
|
|
||||||
### common
|
### Common
|
||||||
|
|
||||||
#### 1. Install TA-Lib
|
#### 1. Install TA-Lib
|
||||||
|
|
||||||
@ -304,11 +351,13 @@ cd ..
|
|||||||
rm -rf ./ta-lib*
|
rm -rf ./ta-lib*
|
||||||
```
|
```
|
||||||
|
|
||||||
*Note*: An already downloaded version of ta-lib is included in the repository, as the sourceforge.net source seems to have problems frequently.
|
!!! Note
|
||||||
|
An already downloaded version of ta-lib is included in the repository, as the sourceforge.net source seems to have problems frequently.
|
||||||
|
|
||||||
#### 2. Setup your Python virtual environment (virtualenv)
|
#### 2. Setup your Python virtual environment (virtualenv)
|
||||||
|
|
||||||
*Note*: This step is optional but strongly recommended to keep your system organized
|
!!! Note
|
||||||
|
This step is optional but strongly recommended to keep your system organized
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
python3 -m venv .env
|
python3 -m venv .env
|
||||||
@ -426,4 +475,4 @@ The easiest way is to download install Microsoft Visual Studio Community [here](
|
|||||||
---
|
---
|
||||||
|
|
||||||
Now you have an environment ready, the next step is
|
Now you have an environment ready, the next step is
|
||||||
[Bot Configuration](https://github.com/freqtrade/freqtrade/blob/develop/docs/configuration.md)...
|
[Bot Configuration](/configuration).
|
||||||
|
@ -1,7 +1,7 @@
|
|||||||
site_name: Freqtrade
|
site_name: Freqtrade
|
||||||
nav:
|
nav:
|
||||||
- About: index.md
|
- About: index.md
|
||||||
- Installation: pre-requisite.md
|
- Installation: installation.md
|
||||||
- Configuration: configuration.md
|
- Configuration: configuration.md
|
||||||
- Start the bot: bot-usage.md
|
- Start the bot: bot-usage.md
|
||||||
- Optimization: bot-optimization.md
|
- Optimization: bot-optimization.md
|
||||||
|
Loading…
Reference in New Issue
Block a user