website/docs/install/linux.md
MassiveBox a553dae19b
Reflect git host and org changes
- Moved from gitea.massivebox.net to git.massivebox.net
- Moved container from massivebox/ecodash to ecodash/ecodash
- Changed social card
2023-05-02 21:50:07 +02:00

2.3 KiB

🐧 Linux

Pre-built binaries are available for Linux systems with x86_64 and ARM architecture. They should work on any distribution, but haven't been tested on all. Please open an issue if problems arise.

If you're not on a supported architecture, please check the Building on Linux guide.
The docker image is recommended over running from binaries.

Download

  1. Grab the appropriate ZIP from the latest release page. Make sure to select the right file for your architecture:
    wget LINK_TO_APPROPRIATE_FILE
  2. Extract the contents. This will create a folder named ecodash in the current directory, which will contain the binary, the configuration, the database and HTML templates folder:
    unzip FILE_NAME
  3. To start the container, first enter the ecodash directory:
    cd ecodash
    Then run it. This will expose EcoDash on port 80 by default:
    ./ecodash
    If you want to run on any other port, use an environment variable like this:
    env PORT=8080 ./ecodash

Set up auto-restart

You might want your EcoDash server to restart automatically in the event of system reboots, programming bugs or configuration saves. This tutorial only covers distributions with systemd.

  1. Create a file at /etc/systemd/system/ecodash.service with this content:

    [Unit] 
    Description=EcoDash
    After=network.target 
    StartLimitIntervalSec=0 
    
    [Service] 
    Type=simple 
    Restart=always 
    User=USER 
    ExecStart=EXTRACTION_PATH/ecodash/ecodash
    
    [Install] 
    WantedBy=multi-user.target
    

    Make sure to replace USER with your username and EXTRACTION_PATH with the path where you performed the wget earlier.

  2. Test if it works:
    systemctl start ecodash

  3. If it does (you don't see any error) you can set the OS to automatically start it after reboots with this:
    systemctl enable ecodash

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/ecodash/ecodash.rss

Moving on

Now that EcoDash is installed, you can proceed to the Setup.