#Installing on Linux

#Installing PostgreSQL

Please refer to the PostgreSQL Installation Guide to install PostgreSQL and create the palpo database and user.

#Downloading Palpo Release

Visit the official GitHub releases page:

https://github.com/palpo-im/palpo/releases

Download the latest version suitable for your Linux distribution and architecture, and extract it.

#Configuring Palpo

Copy the example configuration file and rename it:

cp palpo-example.toml palpo.toml

Edit palpo.toml according to your environment and database settings. At minimum, you need to:

• Set server_name to your desired domain name, for example:

  server_name = "your.domain.com"

• Set the database URL in the [db] section to match the database, user, and password you created above, for example:

  [db]
  url = "postgresql://palpo:your_secure_password@localhost:5432/palpo"

Replace your.domain.com and your_secure_password with your actual domain name and password.

For more advanced configurations, please refer to the Configuration Page.

#Running Palpo

Start Palpo from the command line:

./palpo

#Setting Up as a Systemd Service (Auto-start on Boot)

To automatically start Palpo on boot, you can create a systemd service file:

1. Create /etc/systemd/system/palpo.service with the following content:

   [Unit]
   Description=Palpo Matrix Homeserver
   After=network.target
   
   [Service]
   Type=simple
   User=palpo
   WorkingDirectory=/path/to/palpo
   ExecStart=/path/to/palpo
   Restart=on-failure
   
   [Install]
   WantedBy=multi-user.target

   Replace /path/to/palpo with the actual path to Palpo and set the correct user.

2. Reload systemd and enable the service:

   sudo systemctl daemon-reload
   sudo systemctl enable palpo
   sudo systemctl start palpo

Palpo will now start automatically on boot.