1 install docker
MassiveBox edited this page 2024-04-19 17:18:58 +02:00

🐳 Docker

Docker is the recommended deployment method for EcoDash. It allows to run on different architectures and operating systems without hassle.

Pre-built Docker containers are offered for Linux on ARM and x86_64. If you're not on a supported architecture or operating system, please check the Building the container guide.

Tags

In the examples below, the Docker image is linked as git.massivebox.net/massivebox/ecodash:latest.
The part after the colon is the tag, which defines which version of the software to use. You can change it from latest to one of the supported tags below, according to the level of stability you desire:

  • latest: tracks the latest stable release. Should be fine for most cases.
  • master: tracks the latest update to the code in the master branch of the repository. Might be less stable.
  • vA: tracks the latest release with the major version number being A
  • A.B: tracks the latest release with the major version number being A and minor version being B
  • A.B.C: tracks the release with the specified version.

Consult all the available versions here.

With Docker command-line

docker run -v /absolute/path/to/data/folder:/app/data --name ecodash -p 8080:80 git.massivebox.net/massivebox/ecodash:latest 

This will open the container on port 8080. Replace "8080" in the command with whatever number you want to open that specific port.

With Docker Compose

Create a file docker-compose.yml with the following content:

version: '3'
services:
  ecodash:
    ports:
      - 8080:80
    container_name: ecodash
    image: git.massivebox.net/massivebox/ecodash:latest
    volumes:
      - ./data:/app/data
    restart: always

Run the container with

docker compose up -d

This will open the container on port 8080. Replace "8080" in the file with whatever number you want to open that specific port.

Get notified about new releases

Since EcoDash doesn't have any way to notify admins of new releases, you're encouraged to add our repository's feed into your RSS reader: https://git.massivebox.net/massivebox/ecodash.rss