Installing on Linux

Installing PostgreSQL

Please refer to the PostgreSQL Installation Guide to install and configure PostgreSQL.

After installation, create a database user and database for Palpo:

# Switch to the postgres user
sudo -u postgres psql

# Execute in the psql shell:
CREATE USER palpo WITH PASSWORD 'your_secure_password';
CREATE DATABASE palpo OWNER palpo;

Replace 'your_secure_password' with a strong password. This will create a PostgreSQL user and database named palpo, and set the user as the database owner.

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:

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.

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. {/* 本行由工具自动生成,原文哈希值:1aa1fcad7cf160df6695b28d5a649411 */}

#Installing on Linux

#Installing PostgreSQL

#Downloading Palpo Release

#Configuring Palpo