website/docs/install/linux.md

60 lines
2.3 KiB
Markdown
Raw Permalink Normal View History

2023-02-25 22:04:11 +00:00
# 🐧 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](https://git.massivebox.net/ecodash/ecodash/src/branch/master/BUILD.md) guide.
2023-02-25 22:04:11 +00:00
The [docker image](/docs/install/Docker) is recommended over running from binaries.
## Download
1. Grab the appropriate ZIP from the [latest release page](https://git.massivebox.net/ecodash/ecodash/releases/latest). Make sure to select the right file for your architecture:
2023-02-25 22:04:11 +00:00
`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
2023-02-25 22:04:11 +00:00
## Moving on
Now that EcoDash is installed, you can proceed to the Setup.