Servers.Directory Integration
Connect Servers.Directory to VotePipe using the Votifier protocol. Votes are received over TCP and processed through the same pipeline as webhook votes.
Protocol
Servers.Directory sends votes using the Votifier protocol over raw TCP. VotePipe supports both Votifier V1 (RSA-encrypted) and V2 (HMAC-signed with challenge tokens).
| Property | Value |
|---|---|
| Protocol | Votifier V1 (RSA 2048-bit) & V2 (HMAC-SHA256) |
| Transport | Raw TCP |
| Default Port | 8192 |
| Key Management | Auto-generated by VotePipe, rotatable from dashboard |
Connection Details
When you create a Servers.Directory provider in VotePipe, the following credentials are auto-generated:
| Field | Description |
|---|---|
Host | The VotePipe Votifier server address |
Port | TCP port (default: 8192) |
Public Key | RSA 2048-bit public key (PEM format, for V1) |
Token | HMAC token (for V2 protocol) |
Setup Instructions
Step 1: Create Provider in VotePipe
- Go to Add Provider and select Servers.Directory
- VotePipe will auto-generate your RSA keypair and HMAC token
- Copy the Host, Port, and Public Key shown in the provider details
Step 2: Configure Servers.Directory
- Go to https://servers.directory/
- Click My Servers
- Click Edit on your server
- Scroll down to the Votifier Integration section
- Fill in the Host, Port (default: 8192), and Public Key/Token fields using the values from your VotePipe provider
- Scroll down and click Update to apply the settings
Step 3: Verify
- Cast a test vote on Servers.Directory for your server
- Check the VotePipe dashboard to confirm the vote was received
- Votes will now flow: Servers.Directory → Votifier TCP → VotePipe → Discord + Callbacks + Plugin
Key Rotation
You can rotate your RSA keys and HMAC token at any time from the VotePipe dashboard (Providers → your Servers.Directory provider → Rotate Keys). After rotating, update the public key on Servers.Directory.
Troubleshooting
Votes not arriving
- Verify the host and port match exactly what VotePipe shows
- Ensure the public key was copied completely (including BEGIN/END markers)
- Check that port 8192 is accessible (not blocked by firewall)
- Ensure the provider is enabled in VotePipe
Decryption or signature errors
- The public key on Servers.Directory must match the one shown in VotePipe
- If keys were rotated, update the public key on Servers.Directory
- Try rotating keys in VotePipe and re-configuring Servers.Directory
Still having issues? Check our general troubleshooting guide.
API Management
You can manage providers programmatically using the API: