Installation

​

Prerequisites

​

Software requirements

• .NET 9.0 SDK or later (download here)
• PostgreSQL 13+ (download here)
• Git for cloning the repository

​

External services

• Discord bot token - Create an application at the Discord Developer Portal
• osu! account with IRC access - Get your IRC password from https://osu.ppy.sh/p/irc
• Tournament Discord server with appropriate permissions

​

System recommendations

• RAM: 2GB minimum, 4GB recommended
• Storage: 1GB for application, plus database storage
• Network: Stable connection for IRC and Discord WebSocket

​

Installation

​

Step 1: Install .NET 9.0 SDK

wget https://packages.microsoft.com/config/ubuntu/22.04/packages-microsoft-prod.deb -O packages-microsoft-prod.deb
sudo dpkg -i packages-microsoft-prod.deb
rm packages-microsoft-prod.deb

sudo apt-get update
sudo apt-get install -y dotnet-sdk-9.0

dotnet --version
# Should output: 9.0.x or later

​

Step 2: Install PostgreSQL

sudo apt-get update
sudo apt-get install -y postgresql postgresql-contrib
sudo systemctl start postgresql
sudo systemctl enable postgresql

sudo systemctl status postgresql

​

Step 3: Create the database

sudo -u postgres psql

CREATE DATABASE ss_ims;
CREATE USER ss_ims_user WITH PASSWORD 'your_secure_password';
GRANT ALL PRIVILEGES ON DATABASE ss_ims TO ss_ims_user;
\q

​

Step 4: Clone the repository

git clone https://github.com/ssconexion/ss-integrated-management-server.git
cd ss-integrated-management-server

​

Step 5: Apply the database schema

wget https://gist.githubusercontent.com/Angarn/ddd9cf693aaeeb9407cc46b750fce3e5/raw -O schema.sql
psql -U ss_ims_user -d ss_ims -f schema.sql

​

Step 6: Configure environment variables

cd ss.Integrated.Management.Server
cp .env.example .env

DISCORD_BOT_TOKEN=your_bot_token_here
DISCORD_MATCHES_CHANNEL_ID=1234567890123456
DISCORD_REFEREE_ROLE_ID=1234567890123456
DISCORD_ADMIN_ROLE_ID=1234567890123456
DISCORD_GUILD_ID=1234567890123456

POSTGRESQL_CONNECTION_STRING=Host=localhost;Database=ss_ims;Username=ss_ims_user;Password=your_secure_password

LANGUAGE=en

​

Step 7: Set up your Discord bot

1. Go to the Discord Developer Portal
2. Click “New Application” and give it a name
3. Navigate to the “Bot” section and click “Add Bot”
4. Copy the bot token and paste it into your .env file
5. Under “Privileged Gateway Intents”, enable:
   • Server Members Intent
   • Message Content Intent
6. Navigate to “OAuth2” → “URL Generator”
7. Select scopes: bot and applications.commands
8. Select bot permissions:
   • Read Messages/View Channels
   • Send Messages
   • Create Public Threads
   • Send Messages in Threads
   • Manage Messages
   • Manage Threads
   • Read Message History
9. Copy the generated URL and use it to invite the bot to your server

​

Step 8: Get Discord IDs

1. User Settings → Advanced → Enable “Developer Mode”
2. Right-click on your tournament server → Copy ID (this is DISCORD_GUILD_ID)
3. Right-click on the matches channel → Copy ID (this is DISCORD_MATCHES_CHANNEL_ID)
4. Right-click on the referee role → Copy ID (this is DISCORD_REFEREE_ROLE_ID)
5. Right-click on the admin role → Copy ID (this is DISCORD_ADMIN_ROLE_ID)

​

Step 9: Install dependencies

dotnet restore

• BanchoSharp (v1.5.0) - IRC communication with osu! Bancho
• Discord.Net (v3.18.0) - Discord bot functionality
• Npgsql (v10.0.1) - PostgreSQL database driver
• Entity Framework Core (v9.0.12) - Database ORM
• DotNetEnv (v3.1.1) - Environment variable management
• Google.OrTools (v9.15.6755) - Schedule optimization

​

Step 10: Run the server

dotnet run

hola server de jd

​

Production deployment

​

Using systemd (Linux)

sudo nano /etc/systemd/system/ss-ims.service

[Unit]
Description=SS Integrated Management Server
After=network.target postgresql.service

[Service]
Type=simple
User=your_username
WorkingDirectory=/path/to/ss-integrated-management-server/ss.Integrated.Management.Server
ExecStart=/usr/bin/dotnet run --configuration Release
Restart=always
RestartSec=10
Environment=DOTNET_PRINT_TELEMETRY_MESSAGE=false

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable ss-ims
sudo systemctl start ss-ims

sudo systemctl status ss-ims

sudo journalctl -u ss-ims -f

​

Using Docker (Optional)

docker build -t ss-ims .
docker run -d --name ss-ims --env-file .env ss-ims

​

Development setup

​

Using JetBrains Rider

1. Open Rider and select “Open Solution or Project”
2. Navigate to ss-integrated-management-server.sln
3. Rider will automatically restore NuGet packages
4. Set up your .env file in the ss.Integrated.Management.Server directory
5. Run or debug using the built-in controls

​

Using Visual Studio

1. Open Visual Studio and select “Open a project or solution”
2. Navigate to ss-integrated-management-server.sln
3. Right-click the solution in Solution Explorer → “Restore NuGet Packages”
4. Set up your .env file in the ss.Integrated.Management.Server directory
5. Press F5 to run with debugging

​

Running tests

cd ../ss.Integrated.Management.Server.Tests
dotnet test

​

Database management tools

​

Adminer

wget https://github.com/vrana/adminer/releases/download/v4.8.1/adminer-4.8.1.php
php -S localhost:8080 adminer-4.8.1.php

​

pgAdmin

# Ubuntu/Debian
sudo apt-get install pgadmin4

# macOS
brew install --cask pgadmin4

​

Verification

1. ✅ Check the bot is online in Discord
2. ✅ Run /linkirc to link a referee account
3. ✅ Create a test match with /creatematchup
4. ✅ Start a test ref session with /startref
5. ✅ Verify the Discord thread is created
6. ✅ Check database connectivity by viewing tables in Adminer

​

Troubleshooting

​

Bot won’t start

• Check .NET version: dotnet --version
• Verify .env file exists and has correct values
• Check PostgreSQL is running: sudo systemctl status postgresql
• Review logs for error messages

​

Database connection fails

• Test PostgreSQL connection: psql -U ss_ims_user -d ss_ims
• Verify connection string format in .env
• Check PostgreSQL allows local connections in pg_hba.conf
• Ensure database schema is applied

​

Discord commands not appearing

• Verify bot has applications.commands scope
• Try kicking and re-inviting the bot
• Wait up to 1 hour for global commands to register
• Check bot has appropriate role permissions

​

IRC connection issues

• Verify IRC password at https://osu.ppy.sh/p/irc
• Ensure osu! account is not banned or restricted
• Check you’re not logged into IRC on another client
• Wait 5 minutes between connection attempts

​

Next steps