ElasticView

English

简体中文

English

简体中文

Appearance

Binary Deployment ​

The easiest way to deploy ElasticView is using pre-compiled binary files. This method requires no additional dependencies and works on most systems.

Download ​

Latest Release ​

Download the latest version from our GitHub Releases page.

Available Platforms ​

  • Windows: elasticview-windows-amd64.exe
  • Linux: elasticview-linux-amd64
  • macOS: elasticview-darwin-amd64

Installation Steps ​

1. Download Binary ​

bash
# Example for Linux
wget https://github.com/1340691923/ElasticView/releases/latest/download/elasticview-linux-amd64

# Make executable
chmod +x elasticview-linux-amd64

2. Run ElasticView ​

bash
# Linux/macOS
./elasticview-linux-amd64

# Windows
elasticview-windows-amd64.exe

3. Access Web Interface ​

Open your browser and navigate to:

http://localhost:8080

Configuration ​

Environment Variables ​

Set these environment variables before running:

bash
export EV_PORT=8080
export EV_DB_HOST=localhost
export EV_DB_PORT=3306
export EV_DB_NAME=elasticview
export EV_DB_USER=root
export EV_DB_PASSWORD=password

Configuration File ​

Create a config.yaml file in the same directory:

yaml
server:
  port: 8080
  host: "0.0.0.0"

database:
  host: "localhost"
  port: 3306
  name: "elasticview"
  user: "root"
  password: "password"

Running as Service ​

Linux (systemd) ​

Create a service file:

bash
sudo nano /etc/systemd/system/elasticview.service

Add the following content:

ini
[Unit]
Description=ElasticView Service
After=network.target

[Service]
Type=simple
User=elasticview
WorkingDirectory=/opt/elasticview
ExecStart=/opt/elasticview/elasticview-linux-amd64
Restart=always
RestartSec=5

[Install]
WantedBy=multi-user.target

Enable and start the service:

bash
sudo systemctl enable elasticview
sudo systemctl start elasticview

Windows Service ​

Use tools like NSSM (Non-Sucking Service Manager) to run as a Windows service.

Troubleshooting ​

Port Already in Use ​

If port 8080 is already in use, change the port:

bash
export EV_PORT=8081
./elasticview-linux-amd64

Permission Denied ​

Make sure the binary has execute permissions:

bash
chmod +x elasticview-linux-amd64

Database Connection Issues ​

Verify your database connection settings and ensure the database server is running.

Next Steps ​