Skip to main content

Installing Pluton on Linux Servers

This guide covers installing Pluton on headless Linux servers without a desktop environment.

Prerequisites​

  • Linux server (x86_64 or arm64 architecture)
  • Root/sudo access
  • systemd (most modern Linux distributions)
  • curl

Interactive Installation​

curl -sSL https://dl.usepluton.com/server/scripts/install.sh | sudo bash

Follow the prompts to configure:

  • Server port (default: 5173)
  • Max concurrent backups (default: 2)
  • Encryption key (min 12 characters)
  • Admin username
  • Admin password

Non-Interactive Installation​

For automated deployments, provide all configuration via command line:

curl -sSL https://dl.usepluton.com/server/scripts/install.sh | sudo bash -s -- \
    --port 5173 \
    --max-concurrent 2 \
    --encryption-key "your-secure-encryption-key" \
    --user admin \
    --password "your-secure-password" \
    --non-interactive

Installation with Config File​

Create a configuration file (e.g., /tmp/pluton.env):

PLUTON_ENCRYPTION_KEY=your-secure-encryption-key
PLUTON_USER_NAME=admin
PLUTON_USER_PASSWORD=your-secure-password
SERVER_PORT=5173
MAX_CONCURRENT_BACKUPS=2

Then install:

curl -sSL https://dl.usepluton.com/server/scripts/install.sh | sudo bash -s -- \
    --config /tmp/pluton.env --non-interactive

File Locations​

PathDescription
/opt/pluton/Application binaries
/var/lib/pluton/Data directory (database, logs, backups)
/etc/pluton/pluton.envCredentials (secured, mode 600)
/var/lib/pluton/config/config.jsonNon-sensitive configuration
/var/lib/pluton/logs/Application logs

Uninstalling Pluton​

curl -sSL https://dl.usepluton.com/server/scripts/uninstall.sh | sudo bash

For automated removal including all data:

curl -sSL https://dl.usepluton.com/server/scripts/uninstall.sh | sudo bash -s -- \
    --remove-data --non-interactive

Or use the local uninstall script:

sudo /opt/pluton/uninstall.sh

Managing the Service​

# Check status
sudo systemctl status pluton

# Stop service
sudo systemctl stop pluton

# Start service
sudo systemctl start pluton

# Restart service
sudo systemctl restart pluton

# View logs
sudo journalctl -u pluton -f

Updating Pluton​

curl -sSL https://dl.usepluton.com/server/scripts/install.sh | sudo bash -s -- --upgrade

This preserves your credentials and data while updating the binaries.

Troubleshooting​

View Application Logs​

# Service logs
sudo journalctl -u pluton -f

# Application stdout/stderr
tail -f /var/lib/pluton/logs/stdout.log
tail -f /var/lib/pluton/logs/stderr.log

Check Service Status​

sudo systemctl status pluton

Verify Credentials File​

sudo cat /etc/pluton/pluton.env

Restart After Configuration Changes​

sudo systemctl daemon-reload
sudo systemctl restart pluton