Skip to content
On this page

Installing on Windows

Install on Windows 10+

Installing on windows is very straight forward but you will need to do a handful of things to ensure your environment is setup correctly. There is a lot to cover when installing Athena but these instructions cover nearly everything you need to do in a Windows Environment to get Athena running.

Read them carefully, read them twice, and double check your steps.

Hey Listen!

Athena is not a plug and play game mode. If you cannot script, program, or code and are not willing to learn it is not advised to use this game mode.

Rules for for Folder Paths

This is REALLY IMPORTANT so please read carefully.

File Path Restrictions

  • No special characters in your folder path.
  • DO NOT store Athena in a folder with brackets such as []{}().
  • Plain English folder paths work best
    • If your Windows username contains non-english this may also be an issue.

Do I Need a Server?

No. Wait until you are comfortable using this framework on a locally before renting.

Do not use a VPS, do not use an external windows instance.

Learn to the tools first.


You will need to install, setup, or create accounts for all of the links that are in this section.

Setup SSH Key

You need to add an SSH key to your GitHub account.

Here's a video guide if you need further help.

Ensure MongoDB Running as a Service

MongoDB does not have to be installed locally but if it is this is an important step. Open your Task Manager and ensure that you see MongoDB running as a service.

You can check that MongoDB is running as a service by going into Task Manager > Services

Port Forwarding

Port forwarding is not required for local development. If you need other players to join and test you must open port 7788. If you are putting the server in production mode you must open 7788.

Here's a .bat script that will open both ports in your Windows Firewall.


echo Opening 7788 for TCP
netsh advfirewall firewall add rule name="alt:V-7788-IN-TCP" dir=in action=allow protocol=TCP localport=7788
netsh advfirewall firewall add rule name="alt:V-7788-OUT-TCP" dir=out action=allow protocol=TCP localport=7788

echo Opening 7788 for UDP
netsh advfirewall firewall add rule name="alt:V-7788-IN-UDP" dir=in action=allow protocol=UDP localport=7788
netsh advfirewall firewall add rule name="alt:V-7788-OUT-UDP" dir=out action=allow protocol=UDP localport=7788


If you need additional help with port forwarding in your router you should check out this Port Forward Website where you can find instructions for your router based on brand.

You can verify that ports have been opened successfully after you setup the rest of Athena.

Setup Private Repo

Leave everything as default, do not add any README files or anything else.

Make sure you navigate to the next page where there's a URL ending in .git at the top.

Clone into Private Repository

Open a Windows Terminal such as command line or powershell.

git clone altv-athena-private

Navigate into the folder through command line, or powershell.

cd altv-athena-private

Go back to the page where we created a new private repository, and COPY the URL that is located in the box at the top

I don't specifically mean the URL in this image, go to your private repository page and copy that URL there.

git remote set-url --push origin THE_COPIED_URL_GOES_HERE
git add *
git commit -m "init"
git push origin
git remote add upstream
git remote set-url --push upstream DISABLE
git remote set-url --push origin THE_COPIED_URL_GOES_HERE

If you refresh the GitHub page you should see a clone of Athena inside of your private repository if you were successful.

Pushing updates

When you make changes to the code base you can push it by doing:

git add .
git commit -m "Whatever You Changed"
git push origin master

Installing Dependencies

This installs all NodeJS packages and dependencies that help run the server.

npm install

Installing Server Files

From this point forward you can simply run this npm command to update dependencies.

npm run update

Starting the Server

Hey Listen, normally you start the server through altv-server.exe but we do not do that with Athena. There are other programs that run along-side Athena that allow it to function. You will need to run one of the commands below.

Update the server.cfg

Do not modify the server.cfg, yes you are reading this correctly.

Instead, you should do the following.

Open 1 of the 3 configuration(s) in the configs folder.

You should see any of the following configurations:

  • dev.json
  • devtest.json
  • prod.json

Edit all of these but remember this very important rule.

Do not change 'host' because is correct.

Production Mode

This is the mode you should use when you are having users connect.

Enter the following in a terminal:

npm run windows

Development Test Mode

This is the mode you should use when you are having a limited set of users connect with debug mode on.

Enter the following in a terminal:

npm run devtest

Development Mode

This is the mode you should use when you want to work on making changes. Limited to 1 user joining at a time. This should be used for all your major development. This is the fastest way to develop your game mode and requires the least amount of compile time to test things.

Enter the following in a terminal:

npm run dev

Checking Ports

Check if the ports are currently open while the server is running. Check port 7788.

Check Ports with YouGetSignal


Remember to get the client and connect.

What IP to use?

If you are running this on your local machine you should connect to or if it does not work.

If you are running this on an external server you should connect to the server's IP address.

Created by Stuyk | Est. 2020