Getting Started

Install Ephervex, add an account, and create a disposable Minecraft environment. The desktop app and CLI share the same accounts and instances.

Start here

Install Ephervex for Linux

Choose an AppImage or a package for Debian, Ubuntu, Fedora, or openSUSE. The installation page shows the download and commands for your architecture.

Choose an installation method →

AppImageAPTDNFZypper

Check the installation

Desktop

Open Ephervex from your application menu. If you chose the AppImage, run the downloaded file instead. A new installation opens to Home with an empty host list that says "No client instances yet" and offers New Instance and Import Modpack.

CLI

For a package installation, check the local setup:

ephervex doctor

For an AppImage, run its doctor command from the folder containing the file. Replace x86_64 with aarch64 if you downloaded the ARM build:

./Ephervex-x86_64.AppImage doctor

doctor checks local storage, credentials, bundled data, and Java. It does not download or launch Minecraft.

Create and launch an instance

An offline account is enough for a local test. For authenticated servers, sign in with Microsoft instead; the Accounts guide explains both.

Desktop

Open Settings > Accounts and add an offline account. It appears in the list as an offline account with no credential.

Return to the host list, select New Instance, and enter a name. In the dialog shown below:

1. Choose the exact Minecraft release.
2. Choose Vanilla, or choose Forge or NeoForge and an exact loader build. The example shows Forge.
3. Leave Store persistently off for a disposable test, or turn it on to keep the instance.

Select Launch on the new instance card. The first launch downloads any missing game files and may need a compatible Java runtime.

CLI

Add an offline account and create a temporary Vanilla instance. Replace VERSION with the exact Minecraft release you want:

ephervex account add-offline ExamplePlayer
ephervex instance create "First Test" --minecraft VERSION
ephervex instances list

Use the instance ID from the list to launch it:

ephervex launch INSTANCE_ID

The first launch downloads missing game files and may need a compatible Java runtime. Add --persistent when creating an instance you want to keep.

The interface tour shows where to find mods, servers, logs, diagnostics, and snapshots once your instance is ready. The Instances guide covers storage, copies, per-instance settings, and deletion.