Introduction
Installing Questie manually from GitHub is a straightforward process that requires no third party software. It gives players direct control over which version they install and eliminates any dependency on addon managers running in the background.
The method involves three core steps: finding the correct release on GitHub, downloading and extracting the files, and placing them in the right WoW Classic directory. Done correctly, it takes under five minutes from start to finish.
Quick Facts about Installing Questie Manually from GitHub Releases
- What this method requires: A browser, a ZIP extraction tool, and a WoW Classic installation
- Time to complete: Approximately 3 to 5 minutes
- Official source: github.com/Questie/Questie under the Releases section
- No account, login, or third party application is needed at any point
- Each WoW Classic server type requires its own specific Questie release version
- The addon folder must be named exactly Questie with no version numbers or extra characters
- Manually installed addons do not update automatically and require periodic re download after game patches
- Critical mistake to avoid: Downloading source code ZIP files instead of the packaged addon release
- Safety note: Only download from the official Questie GitHub repository to ensure file integrity and avoid modified versions
What You Need Before Visiting GitHub
Preparation before opening GitHub prevents the most common errors new users encounter. Two pieces of information are essential: your WoW Classic server type and your AddOns folder location.
Having both confirmed before you begin means the entire process runs without interruption or backtracking.
Identifying Your WoW Classic Server Type
Questie is not a single universal file. The GitHub releases page lists separate builds for each Classic environment, and installing the wrong one is the leading cause of Questie failing to load.
The four server types with active Questie support are:
- Classic Era: Permanent vanilla 1.12 servers with no seasonal changes
- Season of Discovery: Modified Classic servers with rune systems and phase content
- Hardcore Classic: Classic Era ruleset with permanent character death on dying
- Wrath of the Lich King Classic: Wrath era servers following a progression timeline
Open your Battle.net launcher and confirm which game entry you launch WoW Classic from. This tells you exactly which release tag to look for on GitHub.
Locating Your AddOns Folder
The AddOns folder is where WoW Classic reads all installed addon files. Its location depends on your operating system and installation directory.
Default paths for standard installations are:
- Windows: C:\Program Files (x86)\World of Warcraft\_classic_\Interface\AddOns
- Mac: /Applications/World of Warcraft/_classic_/Interface/AddOns
If WoW Classic was installed to a custom location, navigate to that directory and follow the same \_classic_\Interface\AddOns subfolder structure. If the AddOns folder does not exist yet, create it manually before proceeding.
What the GitHub Releases Page Contains
The Questie WoW Classic GitHub releases page is the only source players should use for manual installation. It lists every published version of the addon in reverse chronological order, with the most recent release at the top.
Understanding how the page is structured prevents the most critical download mistake: selecting the wrong file type.
Reading the Releases Page Layout
Navigate to github.com/Questie/Questie and click the Releases link in the right hand sidebar of the repository homepage. This opens the full list of published releases.
Each release entry contains:
- A version number and release title at the top of the entry
- A description section noting which Classic versions the release supports
- A changelog or patch notes section describing what changed
- An Assets section that expands to reveal downloadable files
The Assets section is the only place to download the installable addon file. Click the Assets dropdown arrow on the correct release entry to expand it and reveal the available files.
Identifying the Correct File to Download
Once Assets is expanded, you will see several files listed. This is where many players make an error by selecting the wrong option.
The files you will typically see are:
- A ZIP file named Questie followed by a version number such as Questie v10.4.0.zip
- A file labeled Source code (zip)
- A file labeled Source code (tar.gz)
Download only the Questie version numbered ZIP file. The two source code files are raw repository archives intended for developers. They are not structured as installable addons and will not work if placed in your AddOns folder.
| File Type | What It Is | Should You Download It |
| Questie v10.x.x.zip | Packaged installable addon | Yes, this is the correct file |
| Source code (zip) | Raw repository archive | No, not an installable addon |
| Source code (tar.gz) | Compressed repository archive | No, not an installable addon |
| Previous release ZIP | Older addon version | Only if current version has issues |
How to Download and Extract the Questie Files
With the correct file identified, the download and extraction process is simple. A standard ZIP extraction tool is all that is required, and both Windows and Mac include one natively.
No additional software installation is needed for this step on either operating system.
Downloading the Release ZIP File
Click the correctly named Questie ZIP file in the Assets section. Your browser will begin downloading it immediately to your default downloads folder.
Confirm the following before proceeding:
- The file name includes the Questie name and a version number
- The file extension is .zip and not .tar.gz
- The file size is consistent with a small addon package, typically between 1 MB and 10 MB
- The download came directly from github.com and not a mirror or third party site
Do not open or run any executable files from addon download pages. Questie contains no executable files. If a download includes an .exe or .msi file, it did not come from the official repository.
Extracting the ZIP File Correctly
Locate the downloaded ZIP file in your downloads folder. Extract its contents using your operating system’s built in extraction tool or any ZIP utility.
On Windows, right click the file and select Extract All, then choose a destination folder. On Mac, double clicking the ZIP file extracts its contents automatically to the same location.
After extraction, open the resulting folder and confirm its contents. A correctly packaged Questie release will contain addon files including a Questie.toc file visible at the top level of the folder.
The extracted folder name is the most important detail at this stage. It will typically include the version number, appearing as something like Questie v10.4.0. This name must be changed before the folder is moved into your AddOns directory.
How to Place Questie in Your AddOns Folder
This section covers the exact steps for moving the extracted folder into the correct game directory and enabling it. Precision in naming and folder placement determines whether the game recognizes the addon.
Follow each step in the order listed to avoid the most common post extraction errors.
Renaming and Moving the Folder
Before moving anything, rename the extracted folder. The game client reads the folder name to identify addons, and any deviation from the expected name prevents it from loading.
Steps to complete this stage:
- Locate the extracted folder, which will be named something like Questie v10.4.0
- Right click the folder and select Rename on Windows, or click the folder name once on Mac
- Change the name to exactly Questie with a capital Q and nothing else
- No spaces, no version numbers, no suffixes of any kind should remain in the name
- Move or copy the renamed Questie folder into your WoW Classic AddOns directory
- Confirm the final directory path reads as …\Interface\AddOns\Questie\
- Open the Questie folder and verify that a file named Questie.toc is visible directly inside it
If the .toc file is inside a nested subfolder rather than directly in the Questie folder, move the contents up one level so that Questie.toc sits at the top of the Questie directory.
Enabling Questie in WoW Classic
Placing the folder correctly is not the final step. WoW Classic requires addons to be explicitly enabled before they will load.
Complete the activation process as follows:
- Open the Battle.net launcher and launch WoW Classic
- On the character select screen, locate and click the AddOns button in the lower left corner
- Scroll through the addon list to find Questie
- Confirm the checkbox next to Questie is checked and enabled
- If Questie shows a warning labeled out of date, check the box at the top labeled Load out of date AddOns
- Click Okay to close the AddOns panel
- Log in to your character and open the world map
- Confirm that colored quest icons are visible on the map indicating Questie is active
Common Problems and Solutions:
- Questie does not appear in the AddOns list The folder is misnamed or placed in the wrong directory. Recheck the folder name is exactly Questie and that it sits directly inside the AddOns folder
- Out of date warning appears Enable Load out of date AddOns on the character select screen. This is safe and expected after most patch cycles
- Icons do not appear after login Type /reload in chat to refresh the UI. If icons still do not show, relog completely
- Questie.toc not found error The folder contains a nested subfolder instead of direct addon files. Move the contents up one level within the Questie folder
- Wrong quest data displaying You have installed a release built for a different Classic version. Delete the folder and install the version specific release for your server type
- Folder merging caused conflicts Delete the entire Questie folder and replace it cleanly with the newly extracted version. Never merge new files into an old installation

Keeping Questie Updated with Manual Installation
Manual installation means updates do not happen automatically. After each WoW Classic patch, Questie may need a new release to maintain accuracy and compatibility.
Establishing a simple update routine prevents the addon from silently displaying outdated or incorrect quest data between play sessions.
When and How to Check for New Releases
Blizzard patches WoW Classic on a regular schedule, with more frequent updates during active Season of Discovery phases. Each meaningful patch is an opportunity for Questie’s data to become misaligned with live game content.
Check the Questie GitHub releases page when any of the following occur:
- Blizzard announces a new WoW Classic patch or content phase
- Questie begins showing incorrect objective locations or missing quests
- The addon shows an out of date warning that persists after enabling load out of date addons
- You switch to a different Classic server type requiring a different Questie build
Replacing an Existing Questie Installation
When a new release is available, the update process mirrors the original installation exactly with one critical rule: always replace the folder entirely rather than merging files.
Follow these steps for every update:
- Download the new Questie ZIP from the GitHub releases page
- Extract the ZIP to a temporary location
- Rename the extracted folder to exactly Questie
- Navigate to your WoW Classic AddOns directory
- Delete the existing Questie folder completely before placing the new one
- Move the renamed new folder into the AddOns directory
- Launch WoW Classic and confirm Questie is enabled on the character select screen
Merging a new folder into an existing one leaves residual files from older versions. These orphaned files can cause map icon conflicts, incorrect quest tracking, or silent load failures that are difficult to diagnose.
Frequently Asked Questions
Why should I install manually instead of using CurseForge or WowUp?
Manual installation requires no third party software running on your system. It gives you exact control over which version is installed and removes any dependency on an addon manager’s update schedule or interface.
What happens if I download the source code ZIP by mistake?
Source code ZIPs are raw repository archives without the correct addon file structure. WoW Classic will not recognize them as valid addons and they will not appear in the AddOns list on the character select screen.
Does the folder name really matter that much?
Yes. WoW Classic uses the folder name to identify and load addons. Any deviation from exactly Questie including version numbers, spaces, or extra characters will cause the game to ignore the folder entirely.
How do I know which GitHub release matches my server type?
Each release entry on the GitHub releases page includes notes specifying which Classic versions it supports. Look for tags or descriptions mentioning Classic Era, SoD, Hardcore, or Wrath to match your server type.
Is it safe to enable Load out of date AddOns?
Yes. This setting instructs the game client to load addons whose version metadata does not exactly match the current patch number. It has no effect on game security, account safety, or game performance.
How often does Questie release updates on GitHub?
Update frequency varies. During active Season of Discovery phases, updates may arrive weekly. On stable Classic Era servers, releases are less frequent. Check the releases page after any Blizzard patch announcement.
Can I keep backup copies of older Questie versions?
Yes. Storing previous release ZIP files locally allows you to revert to an older version if a new release introduces unexpected issues. Keep the ZIP files in a separate location outside the AddOns folder.
What should I do if Questie loads but shows no icons at all?
First type /reload in the chat window. If icons still do not appear, open the AddOns menu on the character select screen and confirm Questie is checked and enabled. If the issue persists, delete and reinstall the folder cleanly using the steps in this guide.
Latests Posts: