Skip to content

Latest commit

 

History

History
103 lines (90 loc) · 6.73 KB

README.md

File metadata and controls

103 lines (90 loc) · 6.73 KB
Raw

Self Hosted RIPPLE (Windows Edition)

Self-Hosted Ripple Code ! Can be used with a bit modification. (For Personal Use)

Requirements:

Setting up

  • Download or clone the upstream repository with git clone https://github.com/Uniminin/Light-Ripple-Windows.
  • Create and Run MySQL Database Server.
  • Connect to MySQL DB and import RIPPLE SQL query.
  • Go to pep.py, lets & avatar-server Folder and install the necessary python packages with python3 -m pip install -r requirements.txt.
  • Go to lets folder and change my directory to yours in lets/pp/rippoppai.py and lets/pp/relaxoppai.py. Create a replays folder in lets/.data/replays if there isn't any.
  • Edit config.ini and change it. (Both in pep.py & lets folder)
  • Go to api and edit api.conf.
  • Go to Frontend and edit hanayo.conf.
  • You can get OSU!API Key here: OSU!API.
  • Go to nginx-1.16.1 folder and edit the content of conf/nginx.conf, osu/nginx.conf and osu/old-frontend.conf. Replace my directory with your one.
  • You can switch to localhost server and bancho either by LocalHost.exe Switcher or Manually by:
  • Install Certificate
  • Edit Hosts File in c:\Windows\System32\Drivers\etc\hosts. And add this lines to your hosts file.

Host File & Certificate

#<domain that support in certificate> default is i-need-to.click

<127.0.0.1 or your Public IP> osu.ppy.sh
<127.0.0.1 or your Public IP> c.ppy.sh
<127.0.0.1 or your Public IP> c1.ppy.sh
<127.0.0.1 or your Public IP> c2.ppy.sh
<127.0.0.1 or your Public IP> c3.ppy.sh
<127.0.0.1 or your Public IP> c4.ppy.sh
<127.0.0.1 or your Public IP> c5.ppy.sh
<127.0.0.1 or your Public IP> c6.ppy.sh
<127.0.0.1 or your Public IP> c7.ppy.sh
<127.0.0.1 or your Public IP> ce.ppy.sh
<127.0.0.1 or your Public IP> a.ppy.sh
<127.0.0.1 or your Public IP> i.ppy.sh
<127.0.0.1 or your Public IP> <domain that support in certificate>
<127.0.0.1 or your Public IP> c.<domain that support in certificate>
<127.0.0.1 or your Public IP> i.<domain that support in certificate>
<127.0.0.1 or your Public IP> a.<domain that support in certificate>
<127.0.0.1 or your Public IP> old.<domain that support in certificate>

These domains are supported by osu!thailand certificate (You can make your by doing a new self-signed certificate)

  • tatoe.pw
  • i-need-to.click
  • keidas.pw
  • cookiezi.pw
  • kawata.pw

Manually Creating Passwording (DB)

Ripple uses Password -> MD5 -> BCrypt Hash (10 rounds) for the password to login so in users table in password_md5 column in db.

  1. For Example: If you want to make your password ExamplePassword87, first you need to hash it as MD5. So the hash will be df4s5fe65f456344f4re549 (You can hash your password at http://www.md5.cz/).
  2. After hashing it, you'll still need to make it as BCrypt Hash (10 Rounds), you can use https://bcrypt-generator.com/ as BCrypt encryptor.
  3. Put the MD5 Hash to String to encrypt box, change rounds to 10 and then click Hash! button.
  4. You'll get the hash like asdjslkfjlkUy89y32098y*(*@#&(*3y928hih32toij[][;gfgd (which is our MD5 hash. ExamplePassword87).
  5. Put your BCrypt hash in password_md5 in your user data (DB).

Note: The BCrypt hash will be always different because BCrypt hashes it 10 times!

Starting the Server

  • Start MySQL (MySQL Server must be started and running).
  • Start Redis Server, Redis/redis-server.exe.
  • Go to lets folder and run python lets.py (cmd.exe/x-terminal-emulator.exe).
  • Go to pep.py folder and run python pep.py (cmd.exe/x-terminal-emulator.exe).
  • Go to avatar-server folder and run python avatar-server.py (cmd.exe/x-terminal-emulator.exe).
  • Go to api folder and run ./API (bash.exe/WSL).
  • Go to Frontend folder and run ./frontend (bash.exe/WSL).
  • Go to nginx-1.16.1 folder and run nginx (cmd.exe/x-terminal-emulator.exe).

Logging Into osu!

Before you login you have to create an account. You can create an account either by using the/from frontend which is i-need-to.click(default) site or manually from database.

  • Use a local database software to log into local database. I recommend HeidiSQL or dbForge Studio.
  • Log into local db. Then Click on RIPPLE db. Then head find users. And click on Data section above.
  • In id 1000 fill-up your desired username, notes, and email. (It will have full owner/admin access).
  • For Password follow that above section #manually-creating-passwording-db.
  • Then you can login with your username/email and password.

Credits

License 📜

All code in this and its related repositories is licensed under the GNU AGPL 3 License. See the LICENSE file for more information.