Skip to content

Instantly share code, notes, and snippets.

@d-kja
Last active March 14, 2026 11:31
Show Gist options
  • Select an option

  • Save d-kja/74633df5f2d6e55cb2a77c3f9d6acece to your computer and use it in GitHub Desktop.

Select an option

Save d-kja/74633df5f2d6e55cb2a77c3f9d6acece to your computer and use it in GitHub Desktop.
Installing NIKKE under Linux

Running NIKKE on Linux

This guide covers two methods for running NIKKE on Linux using Wine/Proton:

Path 1: Miniloader Path 2: Windows + Steam
Needs Windows No Yes (initial install + every update)
Update process Updates through the launcher Re-download from Windows each time

Requirements

Shared (both paths):


Path 1: Miniloader (using Bottles)

  • Bottles (Flatpak or native package) – you can also use your favorite launcher with the new DWProton thanks to @NelloKudo
  • wine-miniloader

Note

Other launchers that support custom Wine runners (Steam, Heroic, Lutris, etc.) can also work, but this guide focuses on Bottles.


Path 2: Windows + Steam

  • Access to a Windows machine
  • Steam (Linux) — you can use other launchers as well, Steam isn't necessarily the best option specially with the new DW Proton version.
  • DWPROTON or Proton GE
  • A USB drive or way to transfer files

Path 1: Miniloader (Bottles)

1. Install Bottles

Download Bottles via Flatpak or your distro's package manager (e.g., pacman, dnf, yum). Run it once to complete initial setup.

2. Install the Miniloader Runner

  1. Download the miniloader from here — select wine-cachyos-miniloader-fonts-10.0-1-x86_64.tar.xz.
  2. Extract it: tar -xvf wine-cachyos-miniloader-fonts-10.0-1-x86_64.tar.xz
  3. Move the extracted folder to the Bottles runners directory:
    • Flatpak: mv [EXTRACTED_FOLDER] ~/.var/app/com.usebottles.bottles/data/bottles/runners/
    • Native package: mv [EXTRACTED_FOLDER] ~/.local/share/bottles/runners/

3. Create a Bottle (Wineprefix)

  1. Open Bottles
  2. Click Create in the top-right corner
  3. Select Gaming as the environment
  4. Select wine-cachyos as the runner

If wine-cachyos doesn't appear as a runner option, the miniloader wasn't placed in the correct directory.

4. Install Dependencies

  1. Navigate to Dependencies inside your new bottle
  2. Search for and install each of the following:
    • arial or allfonts
    • mfc42
    • vcredist2012
    • vcredist2022

5. Download and Install NIKKE

  1. Download the Windows installer from the official website
  2. In Bottles, click Run Executable and select the installer you downloaded
  3. Wait for the game to finish downloading

6. Add and Run the Launcher

  1. In Bottles, click Add Shortcuts and point it to: <prefix-path>/drive_c/NIKKE/Launcher/nikke_launcher.exe
  2. Run the launcher. If it doesn't start after a few seconds, stop it and try again — it may take a couple of attempts.

Note

A few screenshots to help with the steps: link


Path 2: Windows + Steam

1. Install the Game on Windows

  1. Download the Windows installer from the official website
  2. Install and download the full game (~22 GB)
  3. Copy the entire NIKKE folder to a USB drive or transfer it to your Linux machine
    • The folder is located inside drive_c

2. Set Up Steam

  1. On your Linux machine, download the launcher from the official website, add as a non-Steam game, and run it for the first time using steam.
  2. Find the wineprefix Steam created: ~/.steam/steam/steamapps/compatdata/
    • Non-Steam games will have a random 10-digit folder name. Sort by latest modified to find the right one.
  3. Copy the NIKKE folder (from Windows) into the drive_c directory inside that prefix
  4. Right-click the game in Steam → Properties → set the compatibility layer to Proton GE (or DWPROTON)

3. Configure Steam Launch Settings

  1. Go back to Properties on the game in Steam
  2. Update the executable path to point to the launcher inside the wineprefix: <prefix-path>/drive_c/NIKKE/Launcher/nikke_launcher.exe
  3. Disable Steam Overlay (recommended)

4. Launch the Game

  1. Launch through Steam — the NIKKE launcher will open
  2. Log in and start the game
    • You may need to start and cancel a few times

Note

When the game updates, you will need to re-download the updated game on Windows and repeat steps 1 and 3.


Known Issues & Troubleshooting

Startup Issues

  • The launcher may require multiple start/cancel attempts (3–10 times) before it opens due to a timeout issue.
  • Anti-cheat may complain from time to time, but restarting usually fixes it.

Minor Bugs

  • The launcher will never remember your password. You must re-enter it every time.
  • The game may forget your server region. You'll need to reselect it at launch occasionally.
  • When quitting, you may need to manually click Stop in Steam (Path 2) or stop the process in Bottles (Path 1).

Notes

  • Using DWPROTON instead of Proton GE may reduce the frequency of restart issues (Path 2), but it's not bulletproof.

Tip

Both the patched miniloader and the DWPROTON was created by Dawn Winery, a group that helps with Linux patches for gacha games. If neither of the options worked for you, you can try following this guide: discord link.


Long-term Usage

  • The game has been tested with daily use and remains functional.
  • No bans have been reported, Dawn Winery group has been using their Proton and custom launcher for quite a while without any issues.
@Tonystark-Fe
Copy link

Tonystark-Fe commented Mar 5, 2026

wait the update downloaded just fine for me via just steam launching the game without any additional steps. Also, no warning or anything so far

@d-kja
Copy link
Author

d-kja commented Mar 6, 2026

@larrykoubiak dw, it triggers here and there, but you can just restart and it will work fine. There's a racing condition whenever you're running the app, it's under the Known issues section.

@d-kja
Copy link
Author

d-kja commented Mar 6, 2026

@Tonystark-Fe some updates work, but we faced an issue with a bigger update and had to reinstall the launcher. For that reason, I added the miniloader steps to the original gist as well

@ImRobot777
Copy link

ImRobot777 commented Mar 11, 2026

With the 2nd Method 👍
I'm using DWPROTON (except for the first launcher start in steam in order to create the "Prefix" folder, i've used Experimental Proton)

  • I've add the command WINEDLLOVERRIDES="version=n,b" %command% into the argument of the shortcut in steam
    And use @ghost method for registry (into Protontricks)

Then i have to say that Nikke is running Fine on my Bazzite Linux i've installed on monday !!! And i've never had to lauch the game several times ! Everything works so well !!!

Big Thanks to all of you !

@NelloKudo
Copy link

NelloKudo commented Mar 12, 2026

Small update, dropped dwproton-10.0-20 earlier tonight.
Automated a lot of stuff into it for NIKKE, as well as included the miniloader patch for the installer to work.

With it, the game can now be fully downloaded, installed, repaired (and of course, played) on Linux. Even the launcher updates themselves that previously required to move out the files manually are fixed, made a small python protonfix that automates it.

Give it a try using Heroic/Lutris/Faugus launcher, been working great so far 8)


Also about the ban risk thing you mention in the link, the miniloader patch doesn't really do nothing special besides fixing a race condition that blocked the launcher from working. All Proton/Wine runners that are able to play the game (so even Proton-GE) use and rely on the same patches and none of them modify game files, so ban risk (if any) is the same no matter the runner. Given those same patches have been working all this time, I'm assuming they will continue without issues lol.

@d-kja
Copy link
Author

d-kja commented Mar 12, 2026

Thanks @NelloKudo! Really appreciate the update. I'll update the Gist and try out the new version

@Brian2po
Copy link

This is a great guide for NIKKE PC and works in my Nobara Linux with bottles. As a Linux Newbie like me, this guide is easily digestible.
Any chance that Nikke can be added here in the TwinTail Launcher? Add as a [Game Request] or Will it be complicated for them to add?

@d-kja
Copy link
Author

d-kja commented Mar 13, 2026

@Brian2po Twintail is managed by a different group, but, in short, the main barrier is their encrypted and bloated login

@Brian2po
Copy link

@d-kja I see, that is pretty challenging... I'll just pin this in my profile to always check the current guide for Nikke in Linux,
Thank you all for the Hard Work!
I'll also update here if there is problems when using it in my distro in the future...

On other topic, I asked their CS in email about Linux support, and what I got was a ChatGPT response (but along the email they said that they will forward my message to the Dev team, I doubt it) so I don't think they really plan to make a Linux build/Make the encryption Lenient for it in the future 🥀

@ImRobot777
Copy link

@d-kja I see, that is pretty challenging... I'll just pin this in my profile to always check the current guide for Nikke in Linux, Thank you all for the Hard Work! I'll also update here if there is problems when using it in my distro in the future...

On other topic, I asked their CS in email about Linux support, and what I got was a ChatGPT response (but along the email they said that they will forward my message to the Dev team, I doubt it) so I don't think they really plan to make a Linux build/Make the encryption Lenient for it in the future 🥀

I'm gonna ask for a linux version too (on their X Account).
Let's spam each post they do with that request !!! 😅

@larrykoubiak
Copy link

Small update, dropped dwproton-10.0-20 earlier tonight. Automated a lot of stuff into it for NIKKE, as well as included the miniloader patch for the installer to work.

With it, the game can now be fully downloaded, installed, repaired (and of course, played) on Linux. Even the launcher updates themselves that previously required to move out the files manually are fixed, made a small python protonfix that automates it.

Give it a try using Heroic/Lutris/Faugus launcher, been working great so far 8)

Also about the ban risk thing you mention in the link, the miniloader patch doesn't really do nothing special besides fixing a race condition that blocked the launcher from working. All Proton/Wine runners that are able to play the game (so even Proton-GE) use and rely on the same patches and none of them modify game files, so ban risk (if any) is the same no matter the runner. Given those same patches have been working all this time, I'm assuming they will continue without issues lol.

I've been running it straight from Lutris instead of Steam and it indeed works flawlessly, besides having to retry a few times to launch it. Awesome work @NelloKudo! And indeed no ban so far so i guess they just chose to make the message scarier lol.

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment