Installing on macOS

Installing PostgreSQL

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

You can install PostgreSQL via Homebrew:

brew install postgresql

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

# Start the postgresql service
brew services start postgresql
psql postgres

# 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 Distribution

Visit the official GitHub releases page:

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

Download the latest macOS version (e.g., palpo-x.y.z-macos.zip) 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, 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 and password.

For local testing, set server_name to localhost:port, for example localhost:8008. Also configure the well_known section to specify the client connection address:

[well_known]
client = "http://127.0.0.1:8008"

If using Proxy, make sure to configure the correct client address to ensure external accessibility.

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

Running Palpo

Start Palpo from the command line:

./palpo

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

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

Create a plist file at ~/Library/LaunchAgents/im.palpo.palpo.plist with the following content:

<?xml version="1.0" encoding="UTF-8"?>
<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
<plist version="1.0">
<dict>
    <key>Label</key>
    <string>im.palpo.palpo</string>
    <key>ProgramArguments</key>
    <array>
        <string>/path/to/palpo</string>
    </array>
    <key>WorkingDirectory</key>
    <string>/path/to</string>
    <key>RunAtLoad</key>
    <true/>
    <key>KeepAlive</key>
    <true/>
</dict>
</plist>

Replace /path/to/palpo and /path/to with the actual paths to the Palpo executable and its directory.

Load the service:

launchctl load ~/Library/LaunchAgents/im.palpo.palpo.plist

Palpo will now start automatically upon login. {/* 本行由工具自动生成,原文哈希值:74ae6f66a9f43b899d7aa61cf4e2a720 */}

#Installing on macOS

#Installing PostgreSQL

#Downloading Palpo Distribution

#Configuring Palpo